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This book is for those persons responsible 
for the operation and administration of a 
VM/370 system. 

This operator's guide describes some of 
the hardware of the System/370 as well as 
some user virtual machine requirements. 
The CMS Batch Facility is the only batch 
operation discussed in this publication. 
For general information on how to run batch 
jobs in VM/370 virtual machines (other than 
CMS) , refer to the IBM Virtual Machine 
Fa cility/37 Operating Syst e ms in a Virtual 
Machine, Order No. GC20-1821. 

To manage VM/370 resources effectively, 
a system operator should be familiar with 
the operation and hardware requirements of 
System/370 input/output devices and should 
know the broad concepts of computer 
operations. In addition, the system 
operator should be familiar with the use 
and capability of the Interactive Problem 
Control System component of VM/370.. 
Details of this major component are 
contained in the IBM Virtual M ac hine 
Fac il ity/370 Interactive Problem Control 
System (IPCS) User's Guide, Order No. 
GC20-1 323. 
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To help the system operator gain insight 
in virtual machine concepts and 
capabilities, refer to the IBM Virt ua l 
Machine Facil ity/37 Introduction, Order 
No. GC20-1800. This book briefly discusses 
virtual storage, virtual machines feature 
and facilities of VM/370. 

This publication describes VM/370 system 
startup, logon, VM/370 commands, special 
service programs, user privilege classes, 
as well as other data necessary to manage 
the resources of the system on a daily 
basis. 
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The following terms in this publication 
refer to the indicated support devices: 

• "2305" refers to IBM 2305 Fixed Head 
Storage, Models 1 and 2. 

• «270x" refers to IBM 2701, 2702, and 
2703 Transmission Control Units or the 
Integrated Communications Adapter (ICA) 
on the System/370 Model 135. 

• "3330" refers to the IBM 3330 Disk 
Storage, Models 1, 2, or 11; the IEM 
3333 Disk Storage and Control, Models 1 
or 11; and the 3350 Direct Access 
Storage operating in 3330/3333 Model 1 
or 3330/3333 Model 11 compatibility 
mode. 

• "3310" refers to the IBM 3340 Disk 
Storage, Models A2, B1, and B2, and the 
3344 Direct Access Storage Model B2. 

• "3350" refers to the IBM 3350 Direct 
Access Storage Models A2 and B2 in 
native mode. 

• "3704", "3705", or "370x« refers to IBM 
3704 and 3705 Communications 
Controllers. 

• The term "3705" refers to the 3705 I and 
the 3705 II unless otherwise noted. 

• "2741" refers to the IBM 2741 and the 
3767, unless otherwise specified. 

• "3800" refers to the IBM 3800 Printing 
Subsystem. 



"3850" refers to 
Storage System. 



the IBM 3850 Mass 



"3270" refers to a series of display 
devices, namely the IBM 3275, 3276, 
3277, 3278 Display Stations. A specific 
device type is used only when a 
distinction is required between device 
types. 
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Information about display terminal 
usage also applies to the IBM 3138, 
3148, and 3158 Display Consoles when 
used in display node, unless otherwise 
noted. 

Any information pertaining to the IBM 

3284 or 3286 also pertains to the IBM 

3287, 3288 and the 3289 printers, unless 
otherwise noted. 

For the relationship of the VM/370 
Operators Guide to other VM/370 
prerequisite and corequisite 
publications, refer to Figure 1, The 
VM/370 Library. 



PREREQUISITE PUBLICATIONS 

IBM Virt ual Machine Facility/370; 

Introduction, Order No. GC20-1800 
CMS Oser^s Guide, Order No. GC20-1819 



Terminal Oser f s Guide, Order 
GC2 0-1810 



No. 



If the 3767 Communucations Terminal is 
used as the alternate system console, the 
III 3767 Qjserator^s Guide, Order No. 
GA18-2000, is also a prerequisite. 

The VM/370 CMS User's Guide is a 
prerequisite only if the operator edits 
files used for system control or accounting 
purposes. 



COREQUISITE PUBLICATIONS 



IBM Virtual Machine Facility/370: 

CMS Command and Macro Reference, Order 
No- GC20-1818 

Planning and S ys tem Gene ra tion Guide, 
Order No. GC20-1801 

CMS User's Guide, Order No. GC20-1819 

CP Command Reference for General Users, 
Order NoT GC20-1820 

I If your installation has a 3850 Mass 
j Storage System, the following are 
I corequisite publications: 

I JIM 3850 Mass Storage System (MSS) 
I Introduction and Pre- installation Planning, 
| Order No. GA32-0038~ 



0~/yj> Me ss age Library : Bass St or ag e System 
(I~S) Messages, Order No. GC38-1000. 

IM 385C Mass Storage System (MSS) 
Principles of Operation: Theory, Order No. 
G132-0035. 

I EH 3850 Mass Storage System (MSS) 
Principles of Operation: Reference, Order 
No. GA32-0036. 

Operator's L ib rary: IBM 3850 Mass s to rage 
System (MSS) Under CS/VS, Order" No. 
GC35-0014. 

Information on commands that control the 
virtual machine and its resources 
applicable to the G privilege class user 
are contained in the VM/370 CP Command 
l6f§E®££e for General Users. 

Interactive Problem Control S ys tem (IPCS) 
OserJIs Guide, Order No. GC2 0-1823 

QE§£ating. Systems in a Virtual Machine, 
Order No. GC20-1821 

System Programmer's Guide, Order No. 
GC20-1807 

Sy stem Messages, Order No. GC20-1808 

OLTSEP and Error Recordi ng Guide, Order No. 
GC20-1809 

This publication contains information on 
the VM/370 error recording process. It 
also describes briefly the use of 
CPEREP, the CMS command that uses OS/VS 
EREP for editing and printing 
SYS1.LOGREC and VM/370 error recording 
records. Detailed information on the 
use of the operands of the CPEREP 
command is contained in OS/VS 
Environmental Recor ding MliiM and 
Printing ( EREP ) Program, Order No. 
GC28-0772. 

Gl ossar y and 
GC20-1813 



Master Index, Order No. 



Remote Spooling Com m unic ations S ubsys tem 
(HJCS) User's Guide, Order No. GC20-1816 

The following are corequisite 
publications if your installation has a 
3704 or 3705: 

UJI 3704 Control Panel Guid e, Order No. 
GA27-3086 

I EH 3705 Control Panel Guide, Order No. 
GA27-3087 

Note : References in the text to 
prerequisite and corequisite VM/370 
publications will be given in abbreviated 
form. 
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'.^Indicates that the publication is new in Release 6. 
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Figure 1. The VM/370 Library Publications 
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The entries in this Table of Contents are accumulative. They list additions to this 
publication by the following VM/370 System Control Program Products: 

• VM/370 Basic System Extensions, Program Number 5748-XX8 

• VM/370 System Extensions, Program Number 5748-XE1 

However, the text within the publication is not accumulative; it only relates to the one 
SCP program product that is installed on your system. Therefore, there may be topics and 
references in this Table of Contents that are not contained in the body of this 
publication. 
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VM/370 Release 6 PLC 17 



MISCELLANEOUS 



Changed: Documentation 



This Technical Newsletter incorporates 
minor technical and editorial changes. 
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Summary of Amendments 
for GC20-1806-9 
as updated by GN25-0491 
VM/370 Release 6 PLC 4 



CP DUMP SERVICES VM/370 EXTENDED CONTROL- PROGRAM SUPPORT 

New; Program Support Expanded ; Program Support 

VM/370 provides processing support for Functions of the VM/370 Extended-Control 

the new class G command, VMDOMP. This Program Support (VM/370: ECPS) have been 

command allows the user to dump an expanded to support 3031 attached 

individual virtual machine's entire processor systems. Users can activate 

storage area. Users can process the the (VM/370: ECPS) virtual interval 

VMDUMP command with the VM/IPCS timer and extended virtual machine 

Extension program product or a user assist functions on an individual 

written program. processor basis. The new processor 

address option is valid when issuing SET 
CPASSIST CP commands. 
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Summary of Amendments 

for GC20-1806-9 

VH/370 Release 6 PLC 1 



VM/370 SUPPORTS THE IBM 3800 PRINTING 
SUBSYSTEM 



New ; Hardware Support 

VM/370 Release 6 supports the 3800 
printing subsystem, a high speed, 
non-impact, general purpose printer that 
uses electrophotographic and laser 
technologies to achieve printing speeds 
up to 20,040 lines of copy per minute. 

VM/370 allows virtual machines, 
including virtual VM/370, to attach the 
3800 printer as a dedicated I/O device 
and a spooling device- Release 6 also 
supports the use of the 3800 with a 
starter system before performing a full 
system generation. In addition, the 
BACKSPAC, CHANGE, QUERY, SPOOL, and 
START CP commands have been modified to 
support the features of the 3800 
printer. (See "Section 2: Initiating 
VM/370 Operation"). 



SUPPORT FOR THE IBM 3850 MASS STORAGE 
SYSTEM 



New; Hardware and Programming Support 

VM/370 supports user minidisks on Mass 
Storage System 3330V volumes, where the 
minidisk appears to the virtual machine 
to be defined on a permanently mounted 
IBM 3330-1 drive. 

MSS volumes may also be dedicated and 
attached to a virtual machine as either 
3330V or 3330-1 devices. 

In addition, the new command DEFINE has 

been provided to the user, enabling the 

status of a 3330V volume to be 
redefined. 



LOGON/LINK JODRNALING 



New; Program Feature Option 

VM/370 optionally supports 
journaling of invalid passwords 



the 



specified in the LOGON and AUTOLOG 
commands. The functions of the SET and 
QUERY commands have been expanded to 
support this option. 



LOG SERVICE ROUTINE 



New ; Function and Documentation 

The LOG control record allows the user 
to specify a fix number to a named 
module. The fix number is automatically 
recorded in a log file associated with 
the named module. (See "Section 4; 
VM/370 Service Programs".) 



PASSHORD-ON-THE-COMMAND-LINE SUPPRESSION 



New ; Program Feature Option 

VM/370 optionally supports passowrd 
suppression. This feature gives the 
installation the option to reject LINK 
and LOGON commands in which the password 
is entered from a virtual console on the 
same line as the command. The AUTOLOG 
command is modified to force the user to 
enter the password separately. Commands 
entered from an EXEC or CMS module are 
not affected. 



MONITOR COMMAND 



Changed ; Function and Documentation 

The functions of the MONITOR INTERVAL 
command have been expanded to give 
support to the high-f reguency sampler. 

The new MONITOR SEEKS options enable the 
user to select a subset of DASD devices 
for which data collection can be 
performed. 

The MONITOR LIMIT option has been 
extended to allow specification for 
spool file closure after a number of 
samples have been collected. 
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MULTIPLE ALTERNATE CONSOLE SUPPORT 



MISCELLANEOUS CHANGES 



Changed; Function and Documentation 



Documentation Only 



VM/370 now accepts multiple alternate 
console definitions at system 
generation. If the primary console is 
not operational during VM/370 IPL, the 
list of alternate consoles is searched 
in the order specified in the RIOGEN 
macro statement. The search is 
continued until an operational device is 
found. (See "Section 2: Initiating 
VM/370 Operation".) 



CMS Batch Facility information has been 
removed from this publication as this 
information is contained in the VM/370 
CMS User's Guide , GC20-1819, a 
coreguisite publication. 

Directory Service Program documentation 
has been removed from this publication. 
Duplicate information is fully contained 
in the VM/370 Planning and System 
Generati on Guide , GC20-1801, a 
coreguisite publication. 
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Section 1. Introduction To the Operational 
Control of the VM/370 System 



System operators, in aliost all large System/370 installations, serve in 
an apprentice capacity until they have acquired the skill and knowledge 
to maintain the installation's operating system, be it DOS, OS, or 
VM/370. 

In an apprentice capacity, an operator acquires a basic proficiency 
in mounting, making ready, and loading tape, DASD, line control, and 
other hardware devices. Novice operators also learn the address 
designations of all hardware devices attached to the system. They 
become aware of those system resources that can be switched or patched 
via alternate channel or telecommunication path to expedite system 
operations. The operator becomes aware of system console terminal 
operation as well as the function of most of the indicators, switches, 
buttons, and alarms that are part of the processor control. All of this 
knowledge is basic and must be acquired before considering the 
operational control of any system control program (SCP) . 

The second phase of an operator's training is to be knowledgeable 
about the SCP that is controlling the data processing operations; he 
must be aware of its capability and its operating philosophy. The 
operator must also be aware of the priorities and the demands placed 
upon the system. 

Much of this basic knowledge of VM/370 is described in the VH/370 
Introduction. In that document there is discussion on virtual machines; 
how they are built, identified, and used. Each facet of the virtual 
machine is described: the virtual processor, virtual storage, virtual 
I/O devices, and the virtual system console. Concurrent virtual machine 
usage and spooling operations are also described. The YM/370 
Introduction describes briefly the command language of CP and the other 
components of VM/370, namely, the Conversational Monitor System (CHS) , 
the Interactive Problem Control System (IPCS), and the Remote Spooling 
Communications Subsystem (RSCS). 

With an understanding of YM/370 concepts, the power and versatility 
of VM/370 is soon realized. The system operator is not just controlling 
one process and its related storage and I/O with control and application 
programs; the operator is exercising control over the resources of 
multiple systems (virtual systems). Each virtual system with its own 
system operation, in turn, is being controlled by a user via a terminal 
console. When additional facilities and resources or priorities are 
needed by the virtual system, the virtual system operator must request 
these services from the VM/370 system operator. The system operator 
then delegates additional system resources to the virtual machine, if 
feasible. 

Some of the operations that are exclusive functions performed by the 
YM/370 system operator are as follows: 

• Reorder, purge, or copy any closed spool files 

• Issue warning and high priority messages 

• Attach and dedicate devices to specified virtual machines 

• Automatically logon virtual machines 

• Force users off the system when warranted 
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• Change any virtual machine's dispatch F r i° r ity and operating 
characteristics 

For details on how many of these and other functions are accomplished, 
see "Section 3. CP Commands" in this publication. 

Depending upon the system installation, the system operator may also 
be the operator of a large OS or DOS batch processing system that is run 
in the virtual machine environment. Another duty of the system operator 
is to control the data traffic from remote work stations. Information 
on VM/370 control of such data transfer is detailed in the VH/370 Remote 
Spooling Communications Subsystem (RSCS) User's Guide. 

Regardless of the real system resources and the tasks and procedures 
used, systems are subject to hardware and program malfunction. The 
Interactive Problem Control System of VH/370 provides a method of 
recording and maintaining a history of VM/370 and virtual machine 
program problems. The VH/370 Interactive Problem Control System (IPCS) 
User's Guide provides the details on how to use this system. 

Problems that are a result of a hardware fault are usually detected 
by the hardware itself, and trigger the recording of register contents 
and sense values (related to the occurrence of the error) in VH/370 's 
error recording area. 

Regardless of whether the malfunction origin is hardware or software, 
the system operator (in most cases) is notified of the seriousness of 
the situations- by means of console indicators/alarms or by console 
diagnostic messages. These all serve to inform the operator that: 

• The system operation can continue as before. 

• The system operation can continue with reduced power/resource. 

• System restart and recovery is commencing. 

• System operation is terminated. 

The type of recovery that is attempted is described in "System/370 
Recovery Management Support", which follows. 



System/370 Recovery Management Support 

IEM System/370 attempts correction of most machine errors without 
program assistance. CP is notified, via an interruption, of both 
intermittent and permanent machine errors to allow error recording and 
recovery procedures to start. 

The following recovery features are implemented in the IBM System/370 
hardware: 

• Retry of the failing processor operations 

• Validity checking on processor and control storage to correct all 
single-bit errors 

• I/O operation retry facilities including an extended channel status 
word (ECSW) , which provides channel retry data to channel and control 
unit retry procedures 

• Expanded machine check interruption facilities tc improve error 
recording and recovery procedures 
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MACHINE CHECK HANDLER (MCH) 

You can set the recording aode to record errors corrected by processor 
retry (logically termed as CPU retry) and Error Correction Code (ECC) 
with the SET MODE coamand. In attached processor applications, 
recording aode can be set for either or both processors. For processor 
retry, the default setting is record aode. 

Note; The SET MODE MAIN coamand is invalid for 3031, 3032, and 3033 
processors. 

When processor retry or ECC succeed in correcting errors, and the 
processor is in record aode, the aachine check handler records the 
error. When processor retry or ECC fail, the aachine check handler: 

• Atteapts to isolate the failure to one page frame and makes that page 
frame invalid or unavailable for paging. 

• Atteapts to isolate the failure to one virtual aachine and logs off 
or resets that virtual aachine. 

• Atteapts to isolate the failure to portions of the systea and to 
continue systea operation in degraded aode. 

• Abnoraally terainates the systea when recovery is not possible; or, 
if VM/370 is operating in attached processor mode and the aalfunction 
is isolated to the attached processor and to a particular virtual 
aachine, then, systea operation continues in uniprocessor aode,. 

MCH records an error whenever any of the following conditions occur: 

• Processor retry occurred*. 

• ECC corrected data 1 . 

• Hardware reported a buffer or DLAT (Data Look Aside Table) error. 

• Multiple-bit storage failure. 

• External daaage. 

m storage protection feature daaage. 

• Tiaer error. 

• Systea daaage. 

• Instruction processor daaage. 



CHANNEL CHECK HANDLER (CCH) 

Whenever a channel control check, channel data check, or interface 
control check occurs, the channel check handler (CCH) constructs an 
error record and records the results in an IOERBLOK. The error recovery 
procedures use this IOERBLOK to retry the error. Recovery is not 
atteapted for channel errors associated with virtual aachine I/O events. 



*VM/370 records these errors only under specific conditions. The 
conditions for recording these errors are detailed in the VM/370 OLTSEP 
a nd Error Reco rding Guid e. 
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I/O Error Recording and SVC 76 

VH/370 maintains an error recording area that captures I/O, CCH, and HCH 
error records. Device and control unit detected unit checks during 
VM/370 spooling, paging, and virtual machine I/O errors generate the I/O 
records. 

VM/370 and the virtual machine's LOGREC data set contain recorded I/O 
errors; this double recording occurs when the virtual machine's 
operating system does not invoke SVC 76. 

If the virtual machine operating system invokes SVC 76 and passes the 
correct parameters to VM/370, VM/370 records the error in its own error 
recording area. VM/370 then passes control back to the virtual machine 
operating system, thus bypassing virtual machine error recording 
facilities. 



VM/370 Recovery Features 

The VM/370 recovery features are described mere fully in the VM/370 
OLTSEP and Error Recording Guide. 



RECORDING FACILITIES 

The OS/VS Environmental Recording, Editing, and Printing program (EREP) 
is executed when the CMS CPEREP command is invoked. The output of the 
CPEREP command consists of printed reports whose content depends upon 
the specified (or defaulted) CPEREP operands and upon the input system 
error records. The reports generated by CPEREP have the same format as 
those generated on an OS/VS system. The input system error records may 
be from the VM/370 error recording area or frcm a history tape. The 
history tape may have been produced earlier by CPEREP from the VM/370 
error recording area data or by an OS/VS system from SYS1. LOGREC data. 
Unlabeled tapes produced on OS/VS systems by OS/VS EREP and on VM/370 
systems by CPEREP are compatible and can be transported between systems. 
Data from both systems can also be accumulated on the same tape,. For 
more details on CPEREP, refer to the following publications: VH/370 
OLTSEP and Error Recording Guide and the OS/VS Environmental Recording 
Ed itin g and Printing (EREP) Program. 

If the facilities of an IBM 3850 Mass Storage System (HSS) are used 
with VM/370 virtual machine operations and MSS errors are reflected to 
VM/370 1 s error recording area, CPEREP must be invoked so that 
MSS-related errors recorded in the error recording area can be collected 
on an accumulation (ACC=YES) tape for further processing by the VS 
System Data Analyzer Program (SDA) . Because MSS logged-out data is 
voluminous and the interrelationships of MSS components are complex, it 
is imperative that this service program be used to effectively diagnose 
and isolate mass storage problems. 
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VM/370 Repair Facilities 



The Online Test Standalone Executive Program (OLTSEP) and associated 
Online Tests (OLT) execute in a virtual machine that can run 
concurrently with normal system operations. These programs provide 
online diagnosis of I/O errors for most devices that connect to the 
System/370. 

The service representative (with a CP command privilege class of F) 
can execute online tests from a terminal as a user of the system; CP 
console functions, including the ability to display or alter virtual 
machine storage, are available when these tests are run. Those tests 
that violate VM/370 restrictions may not run correctly in a virtual 
machine environment. 



VM/370 Restart Facilities 



Whenever a system failure causes an abnormal termination of the real 
machine that does not result in a disabled WAIT state, VM/370 attempts 
to reload CP. Often, the operator needs to take no action. The system 
attempts to execute a warm start, thus allowing user's terminals to be 
reconnected (for logon reinitialization by users) and completed spool 
files as well as open console spool files to be maintained. In the 
event of a warm start, device reconfiguration (such as varying a device 
offline) that was performed by the real computing system operator is 
remembered by CP for system spooling devices only. Storage 
reconfiguration data acquired during the process of recovering from real 
storage errors is lost. After a VM/370 system failure, each user must 
re-access VM/370 (LOGON) , and each virtual machine must be reloaded 
(IPLed) . 

Termination of a virtual machine, whether caused by a real computing 
system malfunction or a virtual machine program error, normally does not 
affect the execution of other virtual machines unless the error involves 
shared segments. 

In VM/370 attached processor operations, the priorities and restart 
activities are similar to a uniprocessor mode of operation. However, if 
system damage assessment indicates a nonrecoverable operation on the 
attached processor and the error can be isolated to a virtual machine, 
VM/370 will be continued in uniprocessor mode on the main processor. 
All virtual machines with an AFFINITY setting are automatically reset to 
AFFINITY OFF for subsequent virtual machine processing. (Note, the 
affected virtual machines are placed in console function mode.) If a 
virtual machine was running when the malfunction occurred, its operation 
will be terminated. 

Note; See the VARY PROCESSOR command in "Section 3. CP Commands" for 
instructions on how to vary the attached processor back online. 

If a similar malfunction occurred on the main processor while VM/370 
was operating in attached processor mode, VH/370 terminates. VM/370 
cannot switch to uniprocessor operation on the attached processor unit 
because the attached processor unit has no hardware interface for 
input/output capabilities. 
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Console input Procedures 

CF and CHS commands are never more than eight characters long and can be 
truncated to the minimum size indicated in the command format 
description. The operands, if any, follow the command on the same input 
data line. Host CP and CHS commands may not extend beyond one line 
except on the 3270. Generally, the operands are positional, but some 
commands have keywords to assist in the translation of the command line. 
One or more blanks must separate the command frcm any operands (except 
for some EDIT subcommands) . 

CHS indicates successful command processing with the CHS ready 
message. Error messages occur for erroneous operands. CP does not 
recognize CHS commands. However, a CHS user can issue CP commands 
without leaving the CHS environment. Although net reguired, CP commands 
entered while in the CHS environment should be prefixed with "CP" or 
"#CP" to decrease ¥H/370 table and disk search time. CP then handles 
the command and passes control back to CHS. If the CHS user wants to 
enter CP mode, he can do so by keying in CP cr #CP with no operands 
(that is, no CP commands) or with an attention interruption. For 
details, refer to "Attention Handling" in the VH/370 Termina l User's 
Guide. 

If a user reguires communication with CP before responding to 
specific error messages issued by some virtual machine operating 
systems, he should enter CP mode by keying in fCP with one or more CP 
command lines separated by a logical line end character, or by 
signalling attention; then perform the necessary console functions. 
When returning to the virtual machine environment, the virtual machine 
read will have been canceled by a unit exception, and the virtual 
operating system normally responds by reissuing the read. The user can 
then enter the reguired virtual machine response. 

You, as the 7H/370 system operator, are like other system users, but 
with some important differences: 

• You are allowed to perform certain console functions that the normal 
user is not. 

• Your terminal normally stays in CP mode and is usually ready to 
receive messages from the VH/370 system and other users. 

Unless you are using a 3270 terminal, before you can type a command, 
you must press the REQUEST key (or its eguivalent) on the designated 
VM/370 system console. VH/370 responds with the time, and sets up to 
read data from the console keyboard. You can then enter CP commands 
into the system. 

You can enter all CP commands in lowercase or uppercase, or a mixture 
of both. All system responses are prefixed with the clock time at which 
you entered the command from the primary console. Full descriptions of 
CP commands with a class of A through F are in "Section 3. CP Commands." 

Enter commands into the VH/370 system console by pressing the 
end-of-line function key to terminate the command line. To cancel a 
miskeyed or inappropriate VH/370 command that you partially or totally 
entered into the system, enter the designated logical line delete 
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character (normally, the t symbol) or press the CANCEL key (or its 
equivalent) . 

Note; The CANCEL key on the 3215 cannot cancel lines of input until you 
finish defining the VM/370 systei during system generation. Also, the 
PAZ key or the CANCEL key on the 3270 and 3066 cannot cancel input 
lines. 

For details on supported VM/370 typewriter terminal consoles, display 
terminal consoles and the associated keys that manage the display 
screen, signal attention, and process line records, consult the VM/370 
Terminal User's Guide. 



Operating Procedures 

CP and CMS, with the exception of the special CP service programs and 
certain frequently used CP functions, get all of their system functions 
from disk. Each of the disks may or may not be labeled. If the disks 
are for CMS file residence, or CP paging and spooling (temporary use) , 
you must label each pack with a six-character label in real cylinder 
track record 3 by using the CP Format/Allocate program. 

The VM/370 system is device- independent; each of the volumes that 
have CP labels can reside on any available and defined 2314, 2319, 3330, 
3333, 3340, 3344, 3350 or 2305 direct access storage device. This 
definition occurs at system generation time. The CP system residence 
(SYSRES) volume must be mounted on an available IPL device; then with 
the load switches dialed to that DASD device pressing the LOAD button 
will bring up the system. CP-owned volumes (cne each for paging and 
spooling) must be mounted and ready. All other resident volumes should 
be mounted and ready when the system is started, although they can be 
added later (via the CP ATTACH command) to the system, while it is in 
operation. 

Assignment of Special Performance Options to Logged-on Users: (FAVORED, 
AFFINITY, SASSIST, CPASSIST, RESERVE, PRIORITY, LOCK, and UNLOCK 
commands) : These can be assigned only by an operator with privilege 
class A. 

Handling of Spooled Input and Output: Card decks for users must be fed 
into the real card reader, printed and punched output properly 
distributed, and the unit record equipment and spool data files 
controlled. The control functions for the system's unit record 
equipment and spool data files can be performed only by a class D 
operator. 

litaching and Detaching of User and System Volumes: Devices used by 
virtual machines in dedicated mode must be attached and detached as 
appropriate. Control over the real System/370 computing system's I/O 
can be performed by an operator with privilege class B. 

Operators with these privilege classes must be logged on to perform 
these functions. Below is a directory entry for an operator to perform 
all of these functions: 

USER OPERATOR OPASS 512 1M ABDG 

The system and spooling operators do not require virtual devices or 
options in their VM/370 directory entries unless CHS is used. Multiple 
virtual machines for operators may be set up, each with all or some of 
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the associated privilege classes. The primary system operator must have 
class A assigned in the directory to properly initiate VM/370 operation. 



SYSTEM DEFINITION 

If you intend to define or attach more than 64 virtual devices for a 
single virtual machine, be aware that any single request for free 
storage in excess of 512 doublewords (a full page) may cause the VH/370 
system to issue an appropriate error message if the extra storage is not 
available on a contiguous page. Therefore, two contiguous page frames 
of free storage must be available in order to log on to a virtual 
machine with more than 64 virtual devices (three contiguous page frames 
for a virtual machine with more than 128 virtual devices, etc.) . 
Contiguous page frames of free storage are sure to be available only 
immediately after IPL, before other virtual machines have logged on. 
Therefore, as a system operator you can inhibit the logon of many 
virtual machines until the virtual machine or machines with many I/O 
devices have accomplished logon and are operating. 



SYSTEM INITIALIZATION 

Successful VM/370 system initiali2ation starts with the initial program 
loading of the CP system residence (SYSRES) pack. Whether performing a 
cold, warm, or checkpoint start, the following conditions must be met: 

• The processor, processor storage and all necessary devices (and disk 
volumes) for a minimum VM/370 system, system residence, paging, and 
spooling requirements must be powered up and ready. 

• No unrecoverable catastrophic hardware errors are encountered in the 
initialization and startup phase of bringing the VM/370 system 
online. 

• There must be a matching compatibility between the generated VM/370 
SCP and the System/370 hardware and its attached features. Failure 
of matching compatibility can result in an error message as well as 
VM/370 performance degradation (for example, refer to the VM/370 
sLZ§tem Messages and the message DMKCPI185E). 

System startup involves CP initialization; checkpoint functions; and 
subsequent warm start, checkpoint, or cold start procedures. When you 
turn system power on, you may have to run a CS (control storage) patch 
routine. This is a System/370 operating procedure and this book 
discusses it no further. 

System initialization establishes and maintains the integrity of 
VH/370 even as it is being started. Checkpoint operations provide 
continuity for certain CP functions that are carried over from a 
previous VM/370 session. Checkpoint is invoked at initialization, 
shutdown, and after a system dump. Warm start procedures allow the 
operator to bring the VM/370 system up after a previous abnormal 
termination with certain controls saved from the previous system's 
session that will be used after the current system initialization is 
complete. The operator begins cold start if previously captured VM/370 
session data or controls were destroyed or are invalid. 

To initiate the operation of the VM/370 system, load the CP system 
residence volume. 
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System initialization is simplified if: 

1. All VM/370 resident volumes (specified in the SYSOWN list for 
paging and spooling) are mounted and ready at IPL time. If volumes 
specified in SYSOWN are not mounted when ycu IPL VM/370, they are 
not available to you. You must mount and attach them later if you 
need them by using the ATTACH command. 

2. Volumes containing user minidisks (such as the CMS system residence 
volume) are mounted and ready at IPL time. However, volumes not 
required for startup can be attached to the system after the VM/370 
program is up and operational. 

Once loaded, CP reads the volume identity labels of all available 
DASD devices, and calculates the real machine's storage size. If the 
configuration differs from that specified during system generation 
(SYSOWN volumes not mounted or storage size net equal to SYSCOR) , a 
message is printed at the system console and operation continues. If a 
real machine has more storage than what was specified on SYSCOR, it is 
not used. For example: if a real machine's storage size is 1 megabyte 
and SYSCOR is set to 512K, 512K is used. If less storage is actually 
available in the real machine than the specified SYSCOR value, the 
lesser figure is used. 

If the SYSCOR macro had specified AP=YES and the attached processor 
is unavailable for startup, the system operates in uniprocessor mode 
rather than attached processor mode. 

During the system startup process, the userid designated in DMKSYS is 
automatically logged on as the primary system operator; he must have 
class A command privileges. This process matches the userid supplied by 
the SYSOPR macro (used in system generation) with the user directory. 
If there is an incompatibility between userids, then the automatic 
operator logon process is aborted and system operational control is 
given to the first user with privilege class A who logs onto the system. 

In the case of an automatic logon failure when a privilege class A 
user explicitly logs onto the system, where the system console is either 
a 3210 or 3215 (or a 3138, 3148, or 3158 console in printer keyboard 
mode) , the user must protect the security of his password as there are 
no print-masking or print- inhibiting features on these devices. 

After the operator has logged on, VM/370 prompts him for the type of 
system start desired (whether this is a warm start or not) . 

At this point, the system is ready for normal use. The operator can 
now: 

• Establish a message of the day to be issued to users when they log 
on. 

• Enable communications lines to permit users to log on. 



Time-of-Day Clock 

The Time-of-Day (TOD) clock provides an accurate measure of time, 
independent of system events or activities, and makes accurate 
measurements available for programming applications. When system power 
is turned off, the clock value is lost on some System/370 models. Once 
the time-of-day (TOD) clock has been made operational through the SET 
CLOCK instructions and the TOD ENABLE SET switch, it is incremented at a 
constant rate. This timing operation is not affected by: 
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• Any normal activity or event in the system 

• Wait state 

• Stopped state 

• Instruction-step mode 

• Single-cycle mode 

• Test mode 1 

• System reset 

• Initial program load procedure 

If TOD clock hardware errors occur, the System/370 hardware posts a 
machine check and CP enters a disabled WAIT state. 

The current clock value can be obtained by using the System/370 STOBE 
CLOCK instruction, which causes the current clock value to be stored in 
the storage location specified in the instruction. Thus, virtual 
machines can use the value of the TOD clock for any purpose that their 
users desire. However, virtual machine users cannot set or modify the 
TOD clock. VM/370 uses the TOD clock for establishing certain 
accounting records for the virtual machines as well as gueueing and 
prioritizing tasks for CP and virtual machine operations. 

The privileged System/370 instruction, SET CLCCK, sets the clock to a 
specific value. If certain operating or program conditions exist, CP 
executes this instruction when the system is initialized. When this 
instruction executes, it replaces the current clock value by the value 
specified in the instruction. The SET CLOCK instruction changes the 
clock value only when the TOD ENABLE SET switch is enabled. 

If the installation is configured with an attached processor, it may 
be necessary in the initialization procedure to synchronize the TOD 
clocks. When this occurs, you may be reguested to ready the "TOD ENABLE 
SET" key twice; once to set the clock on the main processor and once to 
"SET and SYNC" the clock on the attached processor. If the clock value 
has previously been established for the main processor, then only one 
prompt message will be issued. Note, that the TOD Enable Set key is 
or'd to the other processors* TOD Enable SET key. This permits the 
setting of the clock from either processor. If the low-order 32 bits of 
the TOD clock are out of synchronization, a TOD Sync check will be 
received. Again, you will be reguested to synchronize the TOD clocks by 
pressing the TOD Enable Set key. 

Details on those segments of VM/370 initialization that are unique 
only to attached processor applications are detailed at the end of the 
System Initialization topic. 

Se tti ng the Clock (Uniprocessor Application) 

If the clock needs to be set, CP prompts you to enter the date by 
issuing the message: 

SET DATE MM/DD/YY: 
You should then enter the date. CP then requests the time: 

SET TIME HH:MM:SS: 
You should then enter the time. 



*The current clock value is lost when the time-of-day microdiagnostic 
tests are being run, or when system power is turned off. 
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Notes: 

1. Enter the required data immediately following the colon (:). If 
you are using a 3270 or a VM/370 supported CPU display console, 
enter the information in the user input area. The information then 
appears in the output display area on the line following the SET 
TIME request. 

2. You should enter a time value that is some 30 to 60 seconds ahead 
of the current time, because CP requests you to press the TOD 
ENABLE SET switch when setting the clock. 

For example, if the date is 03/01/74, and the time will soon be 08:28 
(EST), the exchange on a printing terminal looks like this: 

VM/370 VERSION 1 LEVEL mm/dd/yy 

SET DATE MM/DD/YY : 03/01/74 

SET TIME HH:MM:SS :08:28:00 

PRESS "TOD ENABLE SET" KEY AT DESIGNATED INSTANT 

When you press the TOD ENABLE SET key, CP responds with: 

NOW 08:28:00 EST FRIDAY 03/01/74 
CHANGE TOD CLOCK (YES | NO): 

Note: The previous example executed on a display terminal would show 
your responses on separate lines. 

You now have an opportunity to change the value of the clock. If you 
enter "no", or press the END function key on the console, clock 
initialization ends. If you enter "yes", another series of prompting 
messages permit you to enter a new date and time. 

Programming Note: To VM/370 users, the epoch clock value of all zeros 
indicates the beginning of the day January 1, 1900. To OS and OS/VS 
users, the epoch clock value of all zeros represents the beginning of 
the day January 1, 1960. Thus, OS virtual machine users will find that 
stored clock values differ by 60 years; however, it is possible in OS to 
use 1900 as the base epoch clock value. 



Cold Start 

Cold start procedures are usually invoked only on the initial loading 

operation of a new version of the VM/370 system or if all closed spool 

files, as well as accounting records are lost or rendered unreadable 

because of a hardware error that prevented valid system recovery and 
continuation. 

Failures in system component power, building power, hardware logic, 
the CP program, or some (rare) kinds of user programs can be classified 
as system operating procedure errors; all can require that you start the 
system with a cold start. Some of these malfunctions may require you to 
issue the SHUTDOWN command. If the SHUTDOWN command cannot be keyed in, 
you can press the LOAD button on the System/370 console. Then after the 
appearance of the shutdown message, you should press the LOAD button a 
second time to reload the system with VM/370. VM/370 issues a message 
to you to perform cold start procedures when it recognizes that 
unrecoverable errors have occurred. 
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VM/370 cold start procedures can start after the condition that 
caused the System/370 or the operator to abnormally terminate the VM/370 
system has been corrected. 

If a cold start is required, start it by responding with "cold" to 
the following message. 

hh:mm:ss START ( (COLD | WARM | CKPT| FORCE) (DRAIN)) | (SHUTDOWN) : cold 

A good practice after an abnormal shutdown and cold start procedure 
is for the system operator to incorporate into the LOGMSG the time of 
the unplanned shutdown and that a cold start was done. This tells the 
user that his spooled files were lost, and that reconstruction of some 
of his other files may be in order. 

Note: A warm start is the normal procedure used in recovering accounting 
data and in order to access previously closed spooled output files. CP 
informs you when a warm start cannot be done and requests an alternate 
recovery method. 



Warm Start 

Warm start implies that the previous VM/370 session ended with an 
orderly shutdown procedure. A warm start should be attempted after 
VM/370 has abnormally terminated, and after a successful system dump 
operation. Begin warm start procedures if ycu are not alerted by 
console messages or visual indications that a checkpoint or cold start 
is required. Warm start restores previous spool controls and files; 
accounting records remain valid and are to be kept as a base for 
continuing operations. In many cases, VM/370 recovers from system 
failures and restarts itself* When this occurs, the following message 
occurs at the console: 

VM/370 SYSTEM RESTART 

To begin warm start procedures, key in "warm" or simply press the 
END, ENTER, or RETURN key (depending on the console device) when the 
following message appears at the console: 

hh:mm:ss START ( (COLD | WARM |CKPT| FORCE) (DRAIN) ) | (SHUTDOWN) : 

(If you want to free up all unit record devices, specify "drain". You 
can also specify "warm-drain" to warm start the system and drain all 
unit record devices, or "shutdown" to close down the system.) The warm 
start then proceeds as follows: 

System Init ial iza tion Begins: Portions of the VM/370 control program 
(CP) enter real storage and CP then checks the status of the time of day 
(TOD) clock. If the clock is not set, CP requests the operator to set 
it, as previously described. If the TOD clock is error-free, CP 
examines each DASD to ensure that the volume labels on all DASD packs 
for VM/370 system use are correct. CP determines if the system 
residence (SYSRES) volume was defined and formatted during VM/370 system 
generation. CP also determines if the SYSRES volume resides on a device 
defined as a component of the real I/O configuration. Label and SYSRES 
volume residence errors cause error message printing on the system 
console, and the system startup may abnormally terminate. However, if 
CP finds no errors, it begins its recovery activity that is an 
investigation of the integrity of the previously stored spooling and 
accounting data. 
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CP examines the queues and chains of user spool files and locates 
where they reside on the spool DASD volutes. If VM/370 detects a 
spooling error, a console message alerts the system operator. 

CP checks accounting data for irregularities. If any are found, CP 
displays a message on the system console. 

During VM/370 system generation, the installation designates a 
console or terminal as the primary operator's system console. CP now 
attempts to automatically log on the primary system operator on that 
console or terminal. Multiple alternate consoles can be specified in 
the RIOGEN macro instruction during system generation. If the 
designated VM/370 system console is turned off or not operational, CP 
automatically attempts to log on the operator on the first designated 
alternate console. If operational, this console is used as the VM/370 
primary system console. If not operational and multiple alternate 
consoles were specified during system generation, the next alternate 
console is accessed. The primary and alternate consoles must be among 
the following devices: 

• A real primary or alternate system console 

• A locally attached 3270 

In addition, the alternate console can be any VM/370 supported remote 
terminal on a leased line connected to a 270x transmission control unit. 
Any terminals on switched lines, and leased line terminals connected to 
370U/3705s are not supported as primary or alternate VM/370 consoles. 
If the alternate devices do not exist, or are not ready, automatic logon 
ceases and the VM/370 system enters the disabled wait state. If the 
primary or alternate consoles are operational, but some processing error 
occurs, manual operator intervention is necessary to bring up the VM/370 
system. CP considers the first user to log on VM/370 with privilege 
class A as the primary system operator. No other users are accepted on 
the system until the primary system operator has successfully logged on. 
The system operator* s userid, password, and command privilege class or 
classes are usually stored on the CP system residence volume during 
system installation. 



Checkpoint Start 

If the system could not perform a warm start because of I/O errors or 
invalid data in the warm start area, you can request a checkpoint (CKPT) 
start. This option attempts to initialize the system using the 
information that has been dynamically checkpointed during system 
operation and stored in the checkpoint area. Spool file chains are 
reconstructed; however, the original order of the files is lost. 
Accounting and system message data, recovered under a warm start, is 
lost under a checkpoint start. Also, because each spool buffer must be 
read to reconstruct the record allocation blocks, a checkpoint start 
takes longer than a warm start. 



Fo rce St art 

If the system cannot perform a checkpoint start because of I/O errors or 
invalid data in the checkpoint area, you can request a force (FORCE) 
start. This option operates like the CKPT start except that any spool 
file that contains unreadable or invalid data is dropped from the 
system. 
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When the FORCE option is used, you should not allow any users to log 
on to the system. The system should be devoted to reclaiming and 
putting out as many spool files as possible. When this has been 
accomplished, the system should be re-initialized using the cold (COLD) 
start option. 



Automatic Logon 

CP automatically logs on the primary system operator as soon as CP polls 
the designated system console and finds it ready. Upon successful 
completion of the IPL and system operator logon, the following message 
appears: 

hh:mm:ss LQGMSG- hh:mm:ss EST FRIDAY mm/dd/yy 

It indicates the date and the time of the last LOGHSG setting. The 
following message then appears and provides a general map of storage 
allocations. 

DMKCPI957I STORsssssk,NUCnnnk,DYNdddddk,TRAtttk,FREEffffk,V=Rvvvvvk 

Next, the following message is displayed only if gueued closed spool 
files exist. 

hh:mm:ss FILES: xxx RDR xxx PRT xxx PUN 

The VM/370 system console is now the only enabled terminal on the 
system and you can start the system. 



M anual Logon 

If the automatic logon of the primary system operator fails because the 
VM/370 directory defines no system operator, the following message 
occurs: 

DMKCPI950A AUTO LOGON FAILED; EXPLICIT LOGON REQUIRED 

You should respond by logging on with your userid: 

logon userid 

In the above response, you enter the CP LOGON command, followed by a 
blank and your identifier name (userid) , followed by pressing the end 
function key. CP checks this entry with the values in the VM/370 
directory. if the userid is valid and you have class A command 
privileges, the following message on the console prompts you for the 
next response: 

hh:mm:ss ENTER PASSWORD 

You then key in your password, which is checked against the password 
stored in your VM/370 directory entry. The system is not accessible to 
other users until you log on and enable the necessary teleprocessing 
lines. Maintaining password security on real printer-keyboard system 
consoles is your responsibility because password inhibiting or masking 
is not possible on these devices. 

If the password is valid, the VM/370 system can be started. 
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nit Record Sjgool Files 

After starting the VM/370 system, the system responds with the status of 
the system spool files: 

hh:mm:ss FILES: 031 RDR r 039 PRT, 001 PUN 

The response indicates that a total of 31 spooled reader files, 39 
spooled print files (which also includes closed spooled console files) , 
and 1 spooled punch file were saved at the last system shutdown. 

At this point, if 3705 control units are part of the VH/370 system 
support of remote terminals and the automatic load function for the 3705 
was not generated into the VH/370 system, you invoke the NETWORK LOAD 
command as follows: 

NETWORK LOAD raddr ncpname 

where raddr is the base address of the 3705 and ncpname is the desired 
copy of the 3705 program. For a description of the NETWORK command, see 
"Operator Commands." 

You can then enable any or all of the teleprocessing lines and 3705 
resources for VM/370 users by issuing the CP ENABLE command and NETWORK 
ENABLE command, respectively. For example, pressing the REQUEST 
function key and entering: 

hh:mm:ss enable 50 
enables only line 50, while: 

hh:mm:ss en all 
enables all 3270 and 270x lines. CP responds with: 

hh:mm:ss COMMAND COMPLETE 

when the requested command has been serviced. 

N ote : The same message occurs even if no lines connect to the machine. 
If a patch panel is in use, make sure that all desired lines connect to 
the system. 

The VM/370 system is now operational and waits for users to log on. 
Similarly, if: 

network enable all 

is invoked, the total resources of all VM/370 controlled 3705 control 
units are enabled if the system is equipped with the devices. 

If you performed a system cold start or drained unit record devices, 
you should start the unit record devices at this time. For example, the 
CP command 

start all 

starts all real unit record equipment. The system then responds with 
the status of each unit record device. 
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Mass Storage System Initialization 

If an HSS port is attached to a virtual machine running OS/VS with HSS 
support and the HSS communicator program is running in the virtual 
machine, the control program can cause automatic 3330V volume mount and 
demount in response to any of the following: 

• A virtual machine logs on with a minidisk defined on a system disk 
that is not mounted. The control program attempts to mount an HSS 
volume with the correct volume label. 

• A virtual machine logs on having a dedicate directory statement 
specifying a volid for a volume that is not mounted. The control 
program again attempts to mount an HSS volume with the specified 
volume label. 

• An operator ATTACH command is issued specifying a device address that 
is an HSS 3330V address and volid. The control program attempts to 
mount the volid on the device address as part of the ATTACH 
processing. 

• The operator DEFINE command is used to change the feature (SYSVIET or 
VIRTUAL) of a 3330V containing a mounted volume. The control program 
demounts the volume before completing the DEFINE process. 

• A virtual machine issues a LINK command to link to a virtual device 
that is all or part of a 3330V volume. The control program attempts 
to mount the volume as part of the LINK process. 

The VH/370 control program does not issue orders directly to the mass 
storage control (HSC) . Bather, it passes reguests to an OS/VS system 
with HSS support that is operating in a virtual machine with an HSC port 
dedicated to it. The OS/VS system then issues orders to the HSC and 
passes response information back to the control program. 

In order for the installation to run with full HSS support, an OS/VS 
system must be IPLed in a virtual machine. An HSC port must be 
dedicated to this virtual machine. There are no special reguirements 
for this IPL. The standard installation procedures for IPLing OS/VS in 
a virtual machine should be followed. After the system is IPLed, the 
VH/370 communicator program must be started. If the standard 
installation procedures as documented in the VH/370 Plan ning and System 
Generation Guide have been followed, the communicator program is started 
in the virtual machine through the OS/VS operator command: 

start dmkmss [.pn] 

The [.pn] operand is used only in OS/VS 1 systems to specify the 
partition in which the program is to be started. 

The absence of error messages received from DHKHSS indicates that HSS 
support is initialized. The communicator virtual machine may now be 
disconnected if the installation desires. 

| There are five error messages that the DHKHSS program can produce. 

| If any of these messages are received, then the VH/370 control program 

| will not be able to communicate with the HSS. The messages are as 

| follows: 
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DMKMSS ENDING ERROR - MSS NOT INITIALIZED 



Explanation : The MSS did not get initialized as it should during 
the OS/VS IPL process. Either the virtual machine does not have 
access to the MSC, or there was an MSS error. 

Opera tor respon se: Correct the problem, use the OS/VS VARY command 
to initialize the MSS, then reissue the "start dmkmss" command. 

DMKMSS ENDING ERROR - DCB FOR COMM. DEVICE NOT OPENED 

Exp lan ation: The DMKMSS program was not able to establish 

communication with the VM/370 control program because the OS/VS DCB 

control block could not be opened. The probable cause is the 

definition of the communicator device for the virtual machine. 

Operator response: Contact the system programmer. After the 
problem has been corrected, reissue the "start dmkmss" command. 

DMKMSS ERROR READING MSS CONFIGURATION TABLE 

Explanation: DMKMSS attempted to read one of the MSS configuration 
tables (Configuration Index/Manufacturer's ID Conversion table or 
the Configuration Data Block) and an error was encountered. 

O pera tor response : Contact the MSS system programmer. After the 
problem has been corrected, reissue the START DMKMSS command. 

DMKMSS CPDID NOT FOUND IN MSS CONFIGURATION TABLES 

Explanat ion: DMKMSS has read one of the MSS configuration tables 
(the Configuration Index/Manufacturers ID Conversion table) and 
searched it for a match to this cpuid, but no match was found. 

Operator r esponse : Contact the MSS system programmer. The MSS 
configuration tables may need to be updated. After the problem has 
been corrected, reissue the START DMKMSS command. 

DMKMSS ERROR CREATING MSS CONFIGURATION TABLE 

Explanation : DMKMSS has given CP a list of VUAs associated with the 
central server cpuid. CP has attempted to create its shared and 
nonshared SDG tables, but has encountered an error. 

Opera tor r espon se: Contact the system programmer. After the 
problem has been corrected, reissue the START DMKMSS command. 



Attached Processor Initialization 

In order for the installation to run with an attached processor, it must 
do the following: 

• Specify AP=YES in the STSCOR macro during VM/370 system generation 

• Have the attached processor online during system IPL 
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If the attached processor was generated as part of the system but was 
not online, the following message is issued if the multiprocessing 
feature is installed: 

DHKCPI959H ATTACHED PBOCESSOR HOT ONLINE 

If the attached processor is not reguired, processing can continue. 
However, if the attached processor is reguired, the operator should 
ready the unit and reload the system. 

Assuming AP=YES and the attached processor was online the following 
message is issued. 

DMKCPI958I ATTACHED PROCESSOR NOW OPERATIONAL 

No operator action is reguired; the system will now utilize the attached 
processor. 

If the installation is running with an attached processor, the system 
operator will be issued the following message when the clocks are to be 
synchronized. 

CLOCK SYNCHRONIZATION-PBESS *TOD ENABLE SET 1 

The operator will then press the TOD ENABLE SET key on either 

processor to synchronize the TOD clocks. Note that once the clocks are 

synchronized, it will not be necessary to resynchronize the clocks on 
subseguent IPL operations unless: 

• FE diagnostics are run 

• Power is turned off on either processor 

• The clocks are running but not synchronized 

• A clocks error is encountered during initialization 
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If the clocks should run out of low-order synchronization, after the 
clocks are synchronized (during or after system initialization) , you 
will receive the following message: 

DMKCLK970W TOD CLOCK SYNC CHECK RECEIVED 
CLOCK SYNCHRONIZATION-PRESS »TOD ENABLE SET' 

As before, press the TOD Enable SET Key to synchronize the clocks. 



In terv al Timer 

VM/370 uses the interval timer to support time slicing; therefore, 
during initialization, the system verifies that the interval timer is 
running before virtual machine logon operations are performed- The 
system initialization routine will loop issuing the following message if 
the interval timer is found not running when tested: 

TURN ON THE INTERVAL TIMER 
TURN ON THE INTERVAL TIMER 



The messages cease when the operator complies by enabling the 
interval timer and the system initialization process continues. 

In attached processor application the text of the message indicates 
the processor owning the disabled interval timer. This message reads as 
follows: 



{ 



TORN ON THE ( MAIN \ PROCESSOR INTERVAL TIMER 
ATTACHED J 



To continue, the interval timer must be enabled on the requested 
processor. 

CONSOLE DEFINITION 

The terms "system console", "primary system console", and "alternate 
system console" apply to those console devices that exercise primary 
control of the processor. 

The VM/370 primary system console can be a real system console, a 
real alternate system console, or a local 3270. 

The VM/370 alternate system console can be a real system console, a 
real alternate system console, a local 3270, or any VM/370 supported 
remote terminal on a leased line connected to a 270x transmission 
control unit (TCO) . The VM/370 alternate system console cannot be a 
remote terminal connected to a 370x TCO. 

Note: If the 370x is loaded with the 270x Emulation Program prior to 
initializing VM/370, the 370x then appears to VM/370 as a 270x TCO. 

The following examples show the various configurations that can 
control VM/370 operations. 
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F irst Configuration: 

Real systei console = VH/370 system console 

Real alternate system console = VM/370 alternate system console 

Second Configuration; 

Real system console = Batch virtual machine 

Real alternate system console = VM/370 system console 

Remote terminal = VM/370 alternate system console 

Th ird Configura tion : 

Real system console = VM/370 system console 
Remote terminal = VM/370 alternate system ccnsole 

Fo urth Configur atio n: 

Real system console = Batch virtual machine 

Two locally attached 3277 Display Stations = VM/370 system console 

and alternate system console 

Fifth Configuration: 

Enabled remote terminal (not 3270) = VH/370 alternate system 
console (Ho valid VM/370 primary system ccnsole is designated in 
STS6EN) 

Note: The real system consoles must be turned off to prevent VH/370 
from using them. 

Sixth Confi guration: 

System console = VH/370 system console 
(No VM/370 alternate console designated in SISGEN) 

The first four configurations allow disabling of the VM/370 primary 
console and selection of an alternate VH/370 console; or, conversely, 
reselection of the VH/370 primary console and disabling of the alternate 
console. 

Configurations five and six indicate that VH/370 system generation 
specified no console substitution. Therefore, if the designated VH/370 
system console is inoperative at VH/370 startup, the system enters the 
wait state and cannot continue. After the console becomes operative 
again, VH/370 must be reloaded into the real system. 



DISABLING THE VH/370 PRIHARY CONSOLE 

If the VH/370 primary system console is inoperative, VH/370 
automatically selects the first alternate console (specified in the 
RIOGEN macro instruction) as the console for primary system operation. 
If the first alternate console specified is not operational, an attempt 
will be made to start the next alternate console. If an operational 
console is found, it will be used as the VH/370 system operator's 
console. 
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If intermittent errors occur at the VM/370 console, and all alternate 
consoles are unavailable (or not specified in the RIOGEN macro 
instruction) , issue the DISCONN command and log on again at some other 
terminal. 

If the VM/370 system console becomes inoperative to the point where 
you cannot log off, press the System/370 external INTERRUPT button to 
disconnect you from the failing system console (or alternate console if 
that console is currently controlling the system.) This allows you to 
log on and reconnect to a terminal with a communications line that has 
already been enabled. This terminal can be another system console 
(VM/370 supported device) or a remote terminal attached to a 270x TCO. 
When the primary console is again operative, control can be regained 
from the alternate console by pressing the INTERRUPT button and 
reconnecting using the primary console. 

When the device specified as the alternate console is a communication 
line, VM/370 enables the line. You can then establish a link with the 
processor through a terminal connected to the line. Once the line is 
established, VM/370 proceeds with the normal system initiation* The 
alternate console must not be a telecommunications line on a real IBM 
370x Communications Controller. If the alternate console is an IBM 2741 
Communication Terminal, it must use the EBCDIC transmission code. 

Note ; VM/370 370x supports multiple alternate console selection only in 
270x emulator mode. 

SELECTING A VM/370 ALTERNATE CONSOLE DURING VM/370 INITIALIZATION 

If the VM/370 system console is inoperative, a VM/370 alternate system 
console can start VM/370. To do this, place the primary VM/370 system 
console in a not-ready status. 

Load VM/370 in the normal way (with the System/370 console switches 
and the LOAD key) . When the primary system console (assuming it was 
generated as the VM/370 system console) indicates "not ready," VM/370 
rings the console alarm bell and enables the alternate system console 
(such as a 3210 Model 2, 1052 Model 7, or local 3270 if one is 
specified) or one 2701, 2702, or 2703 transmission control unit (TCU) 
line that has a leased line terminal attached, to allow the system 
operator to log on. The TCU line address must be defined in the REALIO 
module during VM/370 system generation. If the real system consoles are 
dedicated to virtual machine use only, the system can be generated with 
a fictitious VM/370 primary system console address and the same results 
occur as the load operation with the not ready console described above. 

You can now establish a link with VM/370 by using the designated 
device. Once CP identifies the terminal in the normal procedure, the 
operator presses the BREAK, ATTN, RESET, or ENTER key, depending on the 
terminal type. The VM/370 system then performs automatic or manual 
logon procedures, as previously discussed. 



Controlling the 370x Communications Controller 

Because the 3704 and 3705 Communications Controllers are programmable 
devices, in order for them to be controlled by VM/370, they must be 
loaded with an appropriate control program before VM/370 uses them for 
system telecommunications. This loading is normally an automatic 
function of VM/370 system initialization, but it can be performed 
manually. 
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To load a 370x program into the 370x (either manually or 
automatically) , the 370x program must previously have been saved on one 
of the VM/370 system volumes. Specifications in the VM/370 
configuration module, DMKRIO, describe whether the load process is 
automatic or manual. For more information on saving or loading a 370x 
control program, see the VM/370 Planning and System Generation Guid e. 

If manual loading is necessary or desirable for a 370x control 
program, you should use the NETWORK LOAD command as follows: 

NETWORK LOAD raddr ncpname 

where raddr specifies the physical device address of the 370x, and 
ncpname is the name of a 370x control program image. 

If the specified 370x Communications Controller does not reguire 
loading (that is, it already has an active control program loaded) , the 
following message appears on your console: 

DMKNLD461R CTLR raddr IPL NOT REQUIRED; ENTER *YES» TO CONTINUE: 

You should verify that you specified the correct 370 x, and reply "YES" 
only if the load is to be attempted. (Note that execution of the 
NETWORK LOAD command causes the 370x to be reset, thus discontinuing any 
current teleprocessing activity.) 

Other messages relating to the operation of the 370x can appear on 
your console. These messages are described in the VM/37 System 
Messag es* For more information about the facilities of the NETWORK 
command, refer to the "NETWORK Dump Operations", "CP Commands", and 
"NCPDUMP" sections in this book. 



CONSIDERATIONS FOR LOADING ALL 370X CONTROL PROGRAMS 

When using the NETWORK LOAD command to load an EP for the 370x, the 
following events occur: 



Active users are disconnected 

Active I/O operations are reset 

Dedicated devices are detached and released 

Dialed lines are released 

Devices enabled but not dedicated are reset 

Binary synchronous communication are reset 
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SPECIAL CONSIDERATIONS FOE LOADING THE EP 370X CONTROL PROGRAM 

If a 370x Emulation Program (EP) is automatically reloaded after a 370x 
failure, the system may loop after the restart. The message 

DMKRNH463I CTLR XXX UNIT CHECK; RESTART IN PROGRESS 

and two responses 

CTLR XXX DUMP COMPLETE 

CTLR xxx ncpname LOAD COMPLETE 

indicate that the 370x has been reloaded- If the system loops after the 
second response, you, must reset all emulator lines from the 370x control 
panel. 

If the automatic dump feature is not enabled, one of the messages 

DMKRNH462I CTLR raddr UNIT CHECK; IPL REQUIRED 
DMKRNH464I CTLR "raddr 1 CC=3; DEPRESS 370X "LOAD" BUTTON 

indicates a 370x abnormal termination. You must reload the 370x 
Emulation Program with the NETWORK LOAD command. If the system loops 
when an attempt is made to enable the lines, you must reset all emulator 
lines from the 370x control panel. 

The IBM 3704 Contro l Panel Guide and the IBM 3705 Cont rol Panel Guide 
describe the procedure for resetting emulator lines from the 370x 
control panel in its "Generating Channel End/Device End with Emulator 
Program" section. 

A 370x communications controller cannot be used by VM/370, as a 370x r 
unless it has been loaded by VM/370. Use of the ATTACH and DETACH 
commands reset the "loaded" status and, therefore, the 370x will need to 
be reloaded. 
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Messages on Startup and Initialization 

In the course of VM/370 initialization or startup, in addition to the 
normal expected messages that are a part of loading the system, you may 
see other messages to which you must respond. These messages relate to 
functions of initialization, checkpoint : s warm start, and automatic 
checkpoint requirements. These messages and the recommended course of 
action are described in the VM/370 System Messages . 



Console Messages After Startup 

System console messages are in three categories: 

• System operation status messages 

• Virtual machine user messages 

• Hardware and program status messages 

The operator action required depends on the type and content of the 
message. 

SYSTEM OPERATION STATUS MESSAGES 

These messages inform the system operator of the logging on and logging 
off of users, number of spooled files, output printer or punch 
accounting data, device attention conditions, and command completion 
indications. Some of these messages require operator action, while 
others do not. 

MESSAGES FROM VIRTUAL MACHINE USERS 

These messages include requests and inquiries from virtual machine users 
on the system; a sampling of these user messages follows: 

MSG FROM JONES: CAN YOU GIVE ME A TAPE 

MSG FROM SMITH: CAN YOU PUT UP A SCRATCH 181 

MSG FROM SMITH: PLEASE TAKE RING OUT OF 181 NOW 

MSG FROM BROWN: PLS ATTACH 382 

HARDWARE AND PROGRAM STATUS MESSAGES 

These messages include VM/370 error recording messages, VM/370 system 
error information, and I/O error messages related to users of virtual 
machines who have invoked SVC 76. SVC 76 causes VM/370 to send a 
message to the system operator (for I/O error records only) and to 
record the error data in VM/370' s error recording area. The VM/370 
System Messages manual describes these messages. 

For more information about error detection and the recording and 
editing of errors, refer to the V M/370 OLT SEP and Error Recordi ng Guide, 

The following summarizes the action that the operator must take in 
response to an error message: 

1. Determine the severity of the error. 
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2. Take a storage dump if the automatic dump routine failed. 

3. Try to preserve spooling and accounting data by issuing the 
SHUTDOWN command if it has not been done automatically. 

4. Try to force error recording if it did not occur. 

5. Attempt to analyze the problem by whatever means at his disposal 
and if necessary, reallocate resources and priorities. 

6. Call for technical assistance if necessary. 

Whenever there are indications that I/O errors require further 
analysis or that basic integrity of a device needs to be determined, 
other service programs may be invoked to help make such an assessment. 
For example, to test the operational 3344 or 3350 DASD devices, the 
operator may invoke the OS/VS and DOS/VS Analysis Program-1 (AP-1) . 
This utility program, if resident in the OS/VS or DOS/VS library of a 
virtual machine, can be used to check the proper operation of the 
device. The use of this program along with error messages and user 
action is detailed in the QS/VS and DOS/VS Analysis Program- 1 (AP-1) 
5§er Is Guide, GC 2 6^ 38 55. 

In the event that technical assistance is required, it can be 
obtained from the following sources: 

• The customer's own system programmer (s) . 

• The service representative, who has special test equipment for 
hardware problem isolation. 

• The IBM Program Support Representative, who can also assist with 
VM/370 system problem diagnosis. 

You can assist with problem diagnosis by being alert for the 
following error recording messages: 

DMKIOG550E I/O ERROR RECORDING AREA 90 PERCENT FULL; RUN CPEREP 

DMKIOG551E I/O ERROR RECORDING AREA FULL; RUN CPEREP 

You should then dump the error recording data to some other device 
(usually a tape drive) and clear the error recording area to insure 
enough space to record additional error records. Information on how to 
run CPEREP is contained in the VM/370 OLTSEP and Error Recording Guide. 
Additional information on OS/VS EREP, the program to which CPEREP passes 
control is detailed in the OS/VS Environmental Recording Editing and 
HiSiisa (ISIi) Program publication. 

Other errors may not be severe enough to cause VM/370 system failure, 
but might cause a specific virtual machine to abnormally terminate. In 
most cases, the user can IPL the virtual machine again. 

Should the VM/370 machine enter an unexpected WAIT state or loop, see 
the VM/370 System Programmers Guide referring to the section entitled 
"How To Use~the VM/370 Facilities To Debug." 
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I 3800 Printing Subsystem Support 



The 3800 printer is supported with all its functions as a dedicated 
device. It has liaited functional support when it is used as a spooling 
device= Following is a list of features of the 3800 printer: 

• FORMS COHTBOL periits the user to select the amount of vertical space 
between printed lines. Lines can be vertically spaced at 6, 8, or 12 
lines per inch. Different spacings can also be mixed on the sane 
page. 

• FORMS OVERLAY permits photographing of predefined data (forms) on one 
or more pages. The 3800 printer supports the creation of a form on a 
page and the immediate printing of data on that form. 

• PREDEFINED CHARACTER SETS permit the user to select previously 
designated character sets that contain up to 64 characters each. 
Different character sets provide varied character types, sizes, and 
horizontal spacings between the characters. The 3800 supports the 
simultaneous use of two character sets and optionally supports the 
use of two additional character sets. The user can mix characters 
from the different character sets on a single page. Characters are 
referenced within the 3800 through the use of translate tables. Dp 
to four translate tables may be loaded at any one time. 

• CHARACTER SET MODIFICATION permits user modification and extension of 
character sets. 

• COPY MODIFICATION permits printing of predefined data (for example, 
printing the same header on each page) or the suppression of printing 
for selected data. 

• MULTIPLE COPIES permits numerous copies of files and datasets to be 
printed without the use of multiple-ply paper. Numerous copies of a 
single 3800 buffer can also be printed. 

The values that control feature selection and printing on the 3800 
are stored in tables and modules. Through use of the CP commands VM/370 
can display the symbolic names of the translate tables and modules in 
addition to the symbolic name of the library where they are stored. 

Before printing a spool file, VM/370 initializes the 3800 by loading 
it with the translate tables that control feature selection and 
printing. VM/370 provides a capability to purge spool files that cause 
load errors, which occur when a name is specified that does not match 
the specified image library. If PURGE is specified, all spool files 
causing 3800 load errors will be purged. Otherwise, the spool file will 
be held. 



DEDICATED 3800 PRINTER SUPPORT 

VM/370 allows virtual machines, including virtual VM/370, to attach the 
3800 printer as a dedicated I/O device. When attached, the full 
capability of the 3800 is available to the virtual machine. All of the 
functions previously described are available when the 3800 is used as a 
dedicated device, provided the device is specified in the RDEVICE macro 
instruction at systea generation. See the VM/370 Planning and System 
Generation Guide. 
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Performance Options 



VM/370 offers the following performance options to enhance the operating 
efficiency of one or more virtual machines- This enhancement is 
normally at the expense of the performance of ether virtual machines. 
In certain instances, enhancements to a specific virtual machine (or 
multiple virtual machines) are detrimental to the operating efficiency 
of other virtual machines. The performance options are: 

• Virtual machine assist 

• VM/370 Extended Control-Program Support 

• Reserved page frames 

• Favored execution 

• Virtual=real 

• Locked pages 

• Priority 

• Affinity in an attached processor environment 

You can dynamically assign or withdraw any of these options except 
for the virtual=real option (it can only be dynamically withdrawn) from 
virtual machine users during system operations- You can assign to one 
virtual machine a "mix" of performance options, or the options may be 
assigned to separate virtual machines. Efficient use of these options 
depends upon the characteristics of the program applications; the 
number, size, and complexity of the virtual machines being run; and the 
size, I/O configuration, and CPU model of the real computer being used. 

In addition to using these performance options, you can also use the 
SET PRIORITY command to change a virtual machine's execution priority 
and, thereby, change its performance. 

For example, you could assign the following mix of options - 

One virtual machine: 

Reserved Pages=10 
Favored Execution=80% 
Virtual Machine Assist 

Another virtual machine: 
Virtual=Real 
Priority=1 

A third virtual machine: 
Locked Pages=2 

The favored execution (with percentage value specified) , VIRT=REAL, 
and the reserved page option are unique in that each option cannot be 
applied to multiple virtual machines at the same time. However, no such 
restrictions apply to the locked pages, virtual machine assist, VH/370 
Extended Control-Program Support, priority, or favored execution 
(without the percentage value) options; they can be applied to multiple 
virtual machines. 



RESERVED PAGE FRAMES OPTION 

The CP paging routine uses chained lists of available and pageable pages 
to control real storage use. CP assigns pages for users from the 
available list, which it replenishes from the pageable list. 
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Pages that are temporarily locked in real storage are not available 
or pageable. Paging proceeds using demand paging to select the best 
page for swapping- The reserved page option gives a particular virtual 
machine an essentially private set of pages. The pages are not locked; 
they can be swapped, but normally only for the virtual machine for which 
they are reserved. You specify the number of reserved pages for the 
virtual machine as a maximum. When the Pacjs selection routine selects 
an available page for a reserved user, it marks that page reserved if 
the maximum specified for the user has not previously been reached. If 
CP encounters an available (idle) reserved page for the reserved user 
during page selection, it is used whether or not the maximum has been 
reached. 

Only an operator with privilege class A can specify the number of 
reserved pages. Issue the CP SET RESERVE command in the following 
format: 

SET RESERVE userid xx 

where: 

userid is the name of the VM/370 user to whose virtual machine you 
are to assign the reserved page option. 

xx is the maximum number of pages you assign. 

If the CP page selection routine cannot locate an available page for 
other users because they are all reserved, the routine uses one of the 
reserved pages as a last resort. 



FA70RED EXECUTION OPTION 

The favored execution option guarantees that a particular virtual 
machine gets up to a fixed percentage of processor time. Favored in 
this sense means that CP provides execution time up to the specified 
percentage to that virtual machine, E£2ZM§^ that virtual machine can 
use that much processor time. At regular time intervals, the CP 
dispatcher checks the processor time used by the favored virtual 
machine. If the guaranteed percentage is exceeded, the machine gets its 
normal priority for the remainder of the time interval. If the 
percentage used is less than the guaranteed value, the favored virtual 
machine has the highest execution priority until it reaches that 
threshold. You, as the system operator with privilege class A, specify 
the percentage of processor time assured by the favored option in the CP 
SET command. The format of the command is: 

r t 

SET PA70RED userid 1 xx | 

I OFF | 

L J 

where: 

userid is the name of the VM/370 user whose virtual machine is to 
be assigned the favored option 

xx is any percentage value from 1 to 99 

OFF operand stops favored operation. 
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You can assign multiple virtual machines the favored execution option 
only one virtual machine at a time can be assigned a specified favored 
percentage value. 



Example : 



set favored operatns 75 
set favored payroll 
set favored revenue 
set favored hotjobs 



VIETOAL=REAL OPTION 



The virtual=real option permanently relocates the CP nucleus (except for 
real page 0) to provide space in real lower storage to contain the 
largest virtual=real machine. For the virtual machine, each page from 
page 1 to its last or nth page is in its true real storage location; 
only its page zero is relocated. The virtual machine still runs in 
relocate mode, but because each virtual page frame address is the same 
as the real page frame address, the virtual machine requires no CCN 
translation for the virtual machine. Because no CCU translation is 
performed, no check is made of the I/O data addresses. The virtual 
machine must ensure that no I/O data transfer occurs into real page zero 
or beyond the upper boundary of the virtual machine's storage. Failure 
to observe these limits can cause damage to the VH/370 system or to 
other virtual machines. 

Initial program loading of a named or shared system is not allowed in 
the virtual=real machine; the hexadecimal device address must be used. 

Several aspects of the operation of the virtual=real option can 
affect overall system operation: 

1. The area of contiguous storage built for the virtual=real machine 
must be large enough to contain the entire addressing space of the 
largest virtual=real machine. 

2. Only virtual machines with the virtual=real option can use the real 
storage reserved for virtual— real machines. Only one virtual = real 
virtual machine can run at a time- The storage is not available 
for other users, nor for VH/370 use, unless the virtual=real 
machine is not logged on and you issue an UNLOCK command with the 
YIRT=REAL option. When you issue this command, all page frames 
previously reserved for the virtual=real machine are permanently 
relinquished to the available- page pool. Once these virtual=real 
page frames are available to the page pool, no virtual=real machine 
can run until you load VM/370 again (via IPL) . For this reason, it 
is suggested that the virtual=real machine should be a machine with 
high availability and heavy workload demands c It is not possible 
to relinquish only some of the virtual=real page frames (if, for 
example, a smaller virtual=real machine is to be run) . All 
virtual=real page frames are locked until all are released to the 
pool. 
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3. The virtual=real lachine operates in its allocated storage area 
with normal CCW translation in effect until the virtual machine 
operator issues the CP command: 

SET NOTRANS ON 

at tuis time, an subsequent X/G operations occur from the virtual 
CCWs in the virtual=real machine without translation. With NOTRANS 
on, the virtual machine must not perform I/O operations into page 
zero or beyond its addressable limit. As mentioned previously, 
violation of this requirement can cause damage to the VH/370 system 
or to other virtual machines. 

4. If the virtual=real machine performs a reset or IPL, the normal CCW 
translation routine regains control until the virtual machine 
operator again issues the SET NOTRANS ON command. Only the 
virtual=real machine operator can use the command. An operator 
message occurs if the virtual machine enters normal translation 
mode. 

The virtual=real option is used with programs or operating systems 
that dynamically modify channel programs, or that wish to avoid CP 
virtual channel program translation and paging degradation. If 
virtual=real operation is desired, it must be specified at VM/370 system 
generation time. firtual=real assigns the same real storage locations 
to the virtual machine that exist on the real machine (except for page 
zero, which is relocated) . 

For example, in Figure 2, if a DOS system needs 160K bytes to run 
virtual=real, CP puts all but the first 4096 bytes of the program at the 
real storage address locations. Page of the DOS supervisor is the 
only part of the DOS virtual machine that can be relocated, and it 
follows the last real page frame of the DOS machine. Figure 2 also 
shows that the major portion of the CP nucleus is permanently relocated 
into upper storage (except for page zero) whether the virtual=real 
system is operating or not. The real page frame zero remains under 
control of VH/370. CP dedicates 160K nonpageable bytes to the DOS 
machine. 

However, when the user no longer needs the virtual =real machine 
performance option and he logs off, the assigned virtual=real storage 
can be reallocated as available pageable storage for use by other 
virtual machines (assuming that no other users with the VIRT=REAL 
directory have need of the area) . The reallocation of virtual=real 
storage as usable and available storage for other virtual machines is 
controlled by the UNLOCK command and the VIRT=REAL operand. Once the 
pages are released, no virtual=real machine can be run unless VH/370 
itself is reloaded. If more than one virtual machine needs the 
capabilities of running virtual=real (at different times), VH/370 system 
generation parameters must specify the largest virtual machine that is 
to run in the virtual=real environment. A more practical approach may 
be to generate a different version of VH/370 for each virtual=real 
machine, if the storage sizes are substantially different. 
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Figure 2. DOS 160K Virtual=Real Storage Assignments 



LOCKED PAGES OPTION 

If sufficient page frames are available for other users, you can choose 
to lock (fix) one or more specific pages of a virtual machine or the 
pageable CP nucleus in real storage. This performance option differs 
from the other options in that the LOCK command can apply to several 
virtual machines. It is also possible to have the reserved page frames 
option apply to one user's virtual machine , and then have the lock 
option apply to another user's virtual machine. A locked page is 
effective from the time you invoke the lock option until the user logs 
off the system, or until you issue the UNLOCK command. If the page or 
pages that are locked have a high frequency of reference or change 
activity, the lock option, like the reserved option, can cause an 
improvement in the user's virtual machine performance or overall system 
performance because of the reduction in paging activity. 

Notes : 

1. If a named system currently has the locked pages option in effect, 
reloading of the same named system, loading of another named system, 
or a system reset does not affect the locked pages option of a 
virtual machine. The loading of named systems over other named 
systems without using the UNLOCK command beforehand results in pages 
being made unavailable for use if the first named system has locked 
pages in effect. 

2. In an attached processor system shared pages cannot be locked. 

3. You should always prefer the reserved page frames option to the 
locked pages option, if it is not already in use. The LOCK command 
locks specific pages into real storage regardless of activity, while 
the reserved page frames option keeps all the currently most active 
pages in real storage. 
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PRIORITY 

You can assign specific (dispatch) priority values to different 
virtual machines to override the assigned or default priority value 
for each user in the VH/370 directory. In doing so, the virtual 
machine with a lower no value is considered for dispatching before a 
virtual Machine with a higher nn value. You set user priorities by 
using the following class A console function: 

SET PRIORITY userid nn 

where; 

userid is the user's identification 

nn is an integer value from 1 to 99,. The higher the nn value, 
the lower the dispatching priority. 

VH/370 ASSISTANCE - HARDWARE ASSIST 

The overhead associated with CP*s handling of virtual machines and their 

collective I/O resources is extensive and time consuming. To reduce 

this overhead, CP is assisted by System/370 processor hardware that 

duplicates some of the functions provided by CP routines to accelerate 

CPD processing. This hardware assistance to program function is called 

I VM/370 hardware assist. Some form of VH/370 hardware assist is 

| available on all VM/370 supported System/370 systems except the models 

I 155, 155II, 165, 165-3, and 4331. VM/370 hardware assist on certain 

processors can consist of virtual machine assist; on other processors 

VH/370 hardware assistance is composed of virtual machine assist and 

VM/370 Extended Control Program Support (VM/370 ECPS) . 

VM/370 hardware assist is activated when VM/370 is loaded or by the 
use of CP commands, and it is deactivated by CP commands. For the 
command that activates/deactivates the VM/370 hardware assist process, 
refer to the SET command described in "Section 3. CP Commands." The 
status of VM/370 hardware assist may be determined by the use of the 
QUERY command also described in Section 3. 

Virtual Machine Assist 

The virtual machine assist facility (VMA) can be ordered via feature 
number, it is available as an RPQ (Request for price Quotation) , and is 
standard on some processors. For a list of VH/370 supported processors 
and how they support VHA and ECPS see VH/370 Planning and System 
Ge nera tion Guide. On attached processor systems, virtual machine assist 
maybe installed on one or both processors. Virtual machine assist 
relieves CP of some of the processing overhead caused by the simulated 
execution of certain instructions, privileged operation instructions, 
and interrupts of virtual machines. On/off system control of virtual 
machine assist is provided by the A privilege class command: 

SET SASSIST /ON ) [[PROC] nn ] 
(OFF J 

Users of virtual machines, in turn, have discrete control over the 
functions of virtual machine assist by means of directory entry options 
or by command. For control of this function on a virtual machine level, 
refer to the privilege class G command SET ASSIST, described in VH/370 
CP Command Reference for General Users - 
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1^^370 Extended Control-Program Sup port 

VM/370 Extended Control-Program Support is an expansion of the function 
provided by virtual machine assist and consists of three major parts: 

• Expanded virtual machine assist 

• CP assist 

• Virtual interval timer assist 

Expanded virtual machine assist is an expansion of function provided 
by virtual machine assist in that, via hardware, CP is relieved of 
processing some conditions of CP simulated instruction execution that 
were not covered by the virtual machine assist process. Expanded 
virtual machine assist also assists CP in the processing of other 
instructions and privileged operations not emulated by virtual machine 
assist. 

Expanded virtual machine assist is activated for all virtual machines 
when VH/370 is loaded. It is also activated when both class A commands 
are invoked as shown: 

SET SASSIST ON 

— and — 

SET CPASSIST ON 

Expanded virtual machine assist is deactivated when either SET SASSIST 
OFF or SET CPASSIST OFF is invoked. 

The CP assist portion of the VH/370 Extended Control-Program Support 
duplicates via hardware the function provided by various high-usage 
significant overhead portions of CP routines. CP assist is activated 
upon system initialization or by invoking the privilege class A command: 

SET CPASSIST ON 

When the OFF operand of CPASSIST is invoked, CP assist is deactivated 
(as well as expanded virtual machine assist portion of ECPS, if 
previously active) . 

The third function provided by VM/370 ECPS is virtual interval timer 
assist. This hardware assist provides virtual machines with a more 
accurate method of updating the virtual machine* s interval timer 
(location X'50 1 )- Overall system control of this function is by the 
class A commands SET SASSIST ON and SET SASSIST OFF. Control of this 
facility on the individual virtual machine level is by the class G 
command SET ASSIST TUB and SET ASSIST NOTMB. For more details on this, 
refer to the VM/370 CP Command Beference for General Users. 

To summarize the use of the SET CPASSIST and SET SASSIST in 
relationship to virtual machine assist and VM/370 Extended 
Control-Program Support, see Figure 3. 
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Figure 3. Command Control of VM/370 Hardware Assist 



YB/370 Hardware Assist Restrictions 



A virtual machine running in certain virtual machine modes or running 
certain operations cannot use certain facilities provided by VM/370 
hardware assist. When these modes or operations are encountered, the 
action taken is dependent upon the processor facilities of either 
virtual machine assist or VM/370 Extended Control-Program Support. 

For all VM/370 supported processors that have VM/370 hardware assist 
active when the CP ADSTOP or certain CP TRACE command functions are 
encountered, the virtual machine assist is deactivated during the 
interval of their use. 

For System/370 Models 135-3, 138, 145-3, and 148, the use of the DCS 
emulator or PER (Program Event Recording) curtails some of the function 
provided by VM/370 Extended Control-Program Support. For more details 
on VM/370 hardware assist, see the VM/370 System Prograi mer 's Guide. 



AFFINITY 



In Attached Processor systems a virtual machine may be designated to 
execute only on one specified processor. This may be advantageous for 
performance or functional requirements. Performance gains might be 
realized with affinity because of the nature of the workload or the 
availability of performance assists on one processor. Functional 
requirements could be the existence of required operation codes on one 
processor. In either case, CP code executed on behalf of the virtual 
machine may execute on either processor. 
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System Termination 

The VH/370 system may be shut down in one of two ways: 

1. By an operator initiated shutdown. 

2. By an abnormal termination of operation. 

The normal shutdown is initiated by a class A operator entering the 
command 

"shutdown" 

| from the operator's console. If the SHUTDOWN command is ineffective, 
press the LOAD button on the system console once to shut down the system 
(a second pressing of the load button reloads VH/370) . 

The shutdown operation checkpoints spooling and accounting functions; 
in addition* user activity is terminated by automatically logging off 
all virtual machined and disabling communication lines. Open and active 
files on the spool unit record devices are purged and, if applicable the 
SUSPEND order is issued to all 3851 device addresses (suspends HCS 
interface activity to the host virtual machine) . Note that the SUSPEND 
order issued to a Mass Storage Control interface may cause the SHUTDOWN 
command to run longer than usual. 

Note : Before issuing the SHUTDOWN command, a message or warning should 
be sent to all logged-on users so that they can guickly bring their 
virtual machines to an orderly halt. Time should also be allotted to 
the class D (spooling) operator so that he too can terminate in an 
orderly manner the active files being processed on the unit record 
devices. 

The dump unit for VH/370 system failures is specified in the SYSDUHP 
macro during VH/370 system generation, but can be changed by a privilege 
class A or class B system operator. 

If the dump unit is set to disk (by default or via the SET DUHP AUTO 
command) at the time of system failure, the system dumps all or parts of 
real storage to the specified disk and automatically restarts the VH/370 
system. 

When automatically restarted, the system preserves all accounting 
information and spool file data on disk, performs an automatic logon of 
the primary system operator, restores the system LOGHSG, and continues 
system operation. It is not necessary to re-enable the lines, since 
dump and re-IPL automatically re-enable them. The VH/370 online message 
is sent to the terminal users, indicating that they must log on again. 

If, at the time of the system failure, the dump unit is set to a 
printer or tape, the VH/370 system writes the dump on the specified 
unit, preserves the spooling and accounting data, and stops. The 
operator must then re-IPL the VH/370 system as for normal system start 
up, specifying a WARH START to preserve the accounting and spooling file 
data. The operator must re-enable the communication lines to permit 
users to log on again. 

Note: An abnormal termination of an attached processor configuration is 
caused by the same conditions that cause abnormal termination of a 
uniprocessor configuration (uncorrectable hardware error, program check 
during the execution of CP, CP issues abnormal termination reguest 
because of logical processing errors, or the primary system operator 
initiates a STSTEH RESTART). 
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SYSTEM ABEND DUMPS 

Conditions can occur within the CP program that may force an abnormal 
ending condition (ABEND) and cause the dumping of system registers and 
storage. The device that receives these records can be a tape, printer, 
or disk device. 

A system restart dump is taken when the system operator presses the 
SYSTEM RESTART button on the processor console or initiates system 
restart in some other manner as dictated by the processor device type. 
In an AP configuration, the attached processor should not be stopped 
before the system restart is initiated. 

Dumping operations are caused by any program interruptions or system 
restart condition. These interruptions cause routines to gather data 
from registers and storage and place this data on a previously defined 
device. The system CP command SET DUMP defines the guantity of data to 
be dumped. 

For example: 

SET DUMP AUTO 
SET DUMP raddr 
SET DUMP raddr ALL 
SET DUMP AUTO ALL 

SET DUMP AUTO places the VM/370 system dump on a preselected file 
device. (The disk dump area is automatically selected at system 
initialization time if sufficient contiguous space is available.) You 
can verify the device type and address by entering the QUERY DUMP 
command. 

Use SET DUMP raddr when the dump device is to be a high speed printer 
or tape device. The real hexadecimal one to three digit device address 
is substituted for the raddr operand. 

The ALL operand used with SET DUMP AUTO or SET DUMP raddr dumps all 
of storage onto to the DUMP device. If the ALL operand is not 
specified, the system defaults to dumping only those areas that pertain 
to CP, and not those areas that pertain to virtual machine operations. 

If you dump to a disk file, an additional operation is necessary to 
transform these records into readable output for programmers or system 
analysts. You can do this with the CMS VMFDUMP program. 

Note that expanded function is available to the VMFDUMP command as 
generated for the IPCS virtual machine. For more information on this, 
refer to the VM/370 I nteractive Problem Control System ( IPC S) User's 
Guid e. 

If the records are dumped onto a tape drive, other CMS command 
options must be invoked for printout. 

Only abend dumps that are a result of using the SET DUMP AUTO command 
are spooled as a special virtual card reader file. This card reader 
file is assigned during system generation to a specific virtual machine 
user via the SYSOPR macro. The CMS VMFDUMP command formats and prints 
these CP abend dumps. 
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The VMFDUM-P command creates a CMS file from the CP disk dump data and 
prints the dump from the CMS file. 

The VM/Interactive problem Control System Extension (VM/IPCS 
Extension) provides installations with expanded facilities for reporting 
and diagnosing software failure. The VMDUMP command allows the user to 
dump a virtual machine's entire storage area- The VM/IPCS Extension 
program product or a user written program must process the VMDUMP 
command. If you have installed this program, see the VM/Interactive 
Problem Control System Extension User's G uide and Reference, Order No. 
SC34-2020. 
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Section 3. CP Commands 



The CP commands represent a set of interactive consols functions that 
the operator uses to control the VH/370 system, and that permit user 
control of virtual machines. CP indicates the results of command 
processing with a conversational response, if appropriate (for example, 
COMMAND COMPLETE, HISSING ARGUMENT, or INVALID OPTION) . The commands 
that a VM/370 user (including the operator) can issue depend upon the 
user's assigned privilege class (es), as described in the following 
paragraphs. 



PRIVILEGE CLASSES FOR CP COMMANDS 



The CP commands are divided into eight 
privilege class that indicates the type 
are accepted. Each user is assigned, as 
directory, one or more privilege classes 
each class) . The exceptions are users 
NOLOG users have no privilege class and 



groups, each represented by a 
of user from which the commands 
part of his entry in the VM/370 
(Figure 4 shows the function of 
with a password of NOLOG. The 
can only send messages via the 
MESSAGE command or receive spooled output as punched cards or printed 
forms. The NOLOG password allows them to be identified as the 
recipients of spooled output when a virtual machine user spools output 
for them. 
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Class 



A* 



B* 



C* 



D* 



E* 



Fi 



G2 



Any ! 



H 



User and Function 



Primary System Operator; The class A user controls the 
VH/370 system. Class A is assigned to the user at the VH/370 
system console during IPL. The primary system operator is 
responsible for the availability of the VH/370 system and its 
communication lines and resources. In addition, the class A 
user controls system accounting, broadcast messages, virtual 
machine performance options and other command operands that 
affect the overall performance of VM/370. 

Note: The class A system operator who is automatically logged 
on during CP initialization is designated as the primary 
system operator. 

§istem Resource Operator: The class B user controls all the 
real resources of the VH/370 system, except those controlled 
by the primary system operator and spooling operator. 

§I§tem Programmer: The class C user updates certain 
functions of the VM/370 system. 

Spoo lin g Operator: The class D user controls spool data 
files and specific functions of the system's unit record 
eguipment. 

§I§i§i Analyst: The class E user examines and saves certain 
data in the VH/370 storage area. 

Service Representative : The class F user obtains, and 
examines, in detail, certain data about input and output 
devices connected to the VH/370 system. 

General User: The class G user controls functions associated 
with the execution of his virtual machine. 

The Any classification is given to certain CP commands that 
are available to any user. These are primarily for the 
purpose of gaining and relinguishing access to the VH/370 
system. 

Reserved for IBH use. 



^Described in this publication. 

2 Described in the VH/370 CP Command Reference for General Users. 



Figure 4. CP Privilege Class Descriptions 



In most cases, a user is assigned to the class G commands. Any 
attempt by a user to issue a command that is not vithin his command 
classes causes an error response from CP. Figure 5 shows the commands 
that are accepted from each user command class. Some commands fall into 
more than one class. In those cases, the major operands of those 
commands are shown in the classes in which they are valid. 
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OPERATOR COMMANDS 

Section 3 describes CP commands available to users with the privilege 
classes of A, B, C, D, E, and F. These privilege classes are assigned 
to users who Manage the VM/370 system and its spooling and hardware 
resources. The privilege class G commands control the functions of the 
general user's virtual machine. Consult the VM/370 CP Command Reference 
for General Users for information on all G privilege class commands. 
The class of commands described as "Any", which can be used by any user 
of the system, are also described in the VM/370 CP Command Reference for 
General Users. 



NOTATIONAL CONVENTIONS 

The notation used to define the command syntax for VM/370 is: 

• Truncations and Abbreviations of Commands 

Where truncation of a command name is permitted, the shortest 
acceptable version of the command is represented by uppercase 
letters* (Remember, however, that vh/370 commands can be entered 
with any combination of uppercase and lowercase letters.) The 
example below shows the format specification for the INDICATE 
command. 

INDicate 

This representation means that IND, INDI, INDIC, INDICA, INDICAT, and 
INDICATE are all valid specifications for this command name. 

Operands are specified in the same manner. Where truncation is 
permitted, the shortest acceptable version of the operand is 
represented by uppercase letters in the command format box. If no 
minimum truncation is noted, the entire word (represented by all 
capital letters) must be entered. 

Abbreviations are shorter forms of command names and operands. 
Abbreviations for command names are shown below the full name in the 
format box. Abbreviations for operands are shown in the description 
of the individual operands that follows the format box. For example, 
the operand READER has both a minimum truncation and an abbreviation. 
In the format box, it is shown as: 

Reader 

indicating that the minimum truncation is R. In the discussion of 
the READER operand that follows the format blcck, it is shown as: 

READER 
RDR 

indicating that the abbreviation is RDR. Thus, the acceptable 
specifications for the READER operand are: R, RE, REA, READ, READE, 
READER, and RDR. 
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• The following symbols are used to define the command format and 
should never be typed when the actual command is entered. 

underscore _ 
braces { } 
brackets [ ] 

ellipsis ... 

• Uppercase letters and words, and the following symbols, should be 
entered as specified in the format box. 

asterisk * 

comma , 

hyphen 

equal sign = 

parentheses ( ) 

period 

colon : 

• Lowercase letters, words, and symbols that appear in the command 
format box represent variables for which specific information should 
be substituted. For example, "hexloc" indicates that a hexadecimal 
storage location address is to be entered. 

• Choices are represented in the command format boxes by stacking. 

A 
B 

C 

• An underscore indicates an assumed default. If an underscored choice 
is selected, it need not be specified when the command is entered. 

Exam£le 

The representation 

A 

B 

C 

indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, B is 
assumed. 

• The use of braces denotes choices, one of which must be selected. 

Example 

The representation 




indicates that you must specify either A, or B, or C. If a list of 
choices is enclosed by neither brackets or braces, it is to be 
treated as if enclosed by braces. 
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• The use of brackets denotes choices, one of which may be selected. 

Example 

The representation 

r t 

I A | 

I B | 

I C | 

L J 

indicates that you may enter A, B, or C, or you may omit the field. 

• In instances where there are nested braces or brackets on the text 
lines, the following rule applies; Nested operand selection is 
dependent upon the selection of the operand of a higher level of 
nesting. 



Example: 

[Level 1 [Level 2 [Level 3 ]]] 
[filename [filetype [filemode]]] 

Where the highest level of nesting is the operand that is enclosed in 
only one pair of brackets and the lowest level of nesting is the 
operand that is enclosed by the maximum number of brackets. Thus in 
the previous example, the user has the option of selecting a file by 
filename only, or filename filetype only or by filename filetype 
filemode. The user cannot select filetype alone because filetype is 
nested within filename; and, as noted, our rale states: the higher 
level of nesting must be selected in order to select the next level 
(lower level) operand. The same is true if the user wants to select 
filemode; filename and filetype must also be selected. 

An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 

Example 

The representation 

{spoolidl spoolid2...} 

indicates that more than one spoolid may be ceded within the braces. 
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ACNT 



Privilege Class: A 



Dse the 
records 
For each 
used by 
hia or 
record g 
message 
and the 
user can 
ACNT OFF 



ACNT command 
for logged-on u 

user specified 
his virtual a a 
since he logge 
iven when the 
at his terminal 
accumulated ace 

suppress the a 
The format o 



to process accounting data, create accounting 
sers, and reset the accumulated accounting data. 
, an accounting record is created giving the time 
chine since the last ACNT command was issued for 
d on. The record produced is identical to the 
user logs off of VM/370. Each user receives a 

that indicates the accumulated accounting data, 
ounting data for each user is reset to zeros. A 
ccounting message by entering the CP command SET 
f the ACNT command is: 



ACNT 



useridl userid2 ... 
ALL 



where: 
useridl 



specifies the user (s) for which accounting records are to be 
created. Multiple users may be specified on the command input 
line. 



ALL 



specifies that accounting records 
all logged-on users. 



are to be created for 



Responses 



The format of the accounting information message is: 



CONNECT=hh:mm:ss VIRTCPO=mmm:ss.hh TOTCPD=mmm: ss.hh 
where: 



CONNECT hh:mm:ss 



is the actual clock time spent in the user's current 
terminal session or the time elapsed since the ACNT 
command was last issued for the user. 



VIRTCPD mmm: ss.hh is the processor time spent in executing 

instructions within the virtual machine. 

TOTCPD mmm: ss.hh is the processor time spent in executing 

instructions within the virtual machine plus 
processor time used by the control program in 
maintaining the virtual machine (paging, I/O, etc.) . 
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ATTACH 

Privileg e Clas s: B 

Ose the ATTACH command to logically connect a real device to a virtual 
machine for that virtual machine's exclusive use, or to logically 
connect a DASD device for CP access and control. The operator usually 
issues the ATTACH command to fulfill a user 1 s request. The format of the 
ATTACH command is: 

ATTach | raddr [To] Juserid [As] vaddr [R[/0]] [3330V] [VOLID volid]) 

(SYSTEM [As] VOlid J 

(raddr... "1 

\raddr-raddrj [TO] userid [R[/0]] [3330V] 



where : 

raddr 

raddr... 

raddr-raddr 

is the real address (cuu) of the device to be attached. 

On the command line, one real device address, multiple real 
device addresses, or a range of real device addresses can be 
specified. 

When the multiple or range form of raddr entry is used, the 
real addresses are identical to the virtual addresses. When 
the range form of raddr is used (raddr-raddr) , the values 
Cuu-cuu must be entered with no imbedded blanks. The range 
supplied must be contiguous addresses in ascending order with 
the second address in the range being greater than the first, 

TO 

userid is the user identification of the virtual machine that 
is to receive the device (s) . The user must be logged on to 
receive the device (s). If the class B user is attaching the 
device to his own virtual machine, the userid can be specified 
as an asterisk (*) . If the optional keyword "TO" is omitted, 
the userid cannot be "TO" or "T". If a numeric userid of less 
than four characters is specified with a range of addresses or 
multiple device addresses, "TO" must be specified. When 
specifying a userid that could also be a valid hexadecimal 
device address (for example, virtual machine id CE) , the "TO" 
operand must be specified to distinguish it as a userid. 

[AS] vaddr 

is the virtual address (cuu) to be assigned to the device. If 
the optional keyword "AS" is omitted, vaddr cannot be "A" or 
"AS". For use of the vaddr operand, see Usage Note 6. 

R/0 is optionally used for DASD devices that are attached to a 
user. This allows the system operator to apply read-only 
protection to a user's disk. The R/O operand may be truncated 
to R. The R/0 operand is ignored for all devices for which it 
does not apply whenever more than one address is specified on 
the command line. 
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3330V 
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[TO] SYSTEM 

specifies, along with volid, that the DASD device is to be 
made available to CP for accessing users 1 disks and/or for 
paging and spooling functions. 

[AS] volid 

is the volume label of the volume on the raddr being attached. 
This operand has the following meanings when used with the 
various forms of the ATTACH command: 

• When used to attach an available raddr to a userid and the 
raddr is a 3330V, the MSS volume with the label volid is 
mounted on the raddr during the attach. 

• When used to attach an raddr to the system and the raddr is 
not a 3330V, the volume label of the volume on raddr is 
verified. 

• When used to attach an available raddr to the system and 
the raddr is a 3330V, the MSS volume with the label volid 
is mounted on the raddr during the attach. 

• When used to attach an raddr to a userid and the raddr is 
not a 3330V, the volid operand is invalid. 

specifies that the vaddr is to be treated as a 3330V. The 
VM/370 control program assumes the virtual machine contains 
MSS device support. Conseguently, MSS cylinder fault support 
is not invoked for the vaddr. 

VOLID volid 

VOLID is a reguired keyword and 'volid 1 is the volume label 
for the 3330V being attached. 

Usage Notes : 

1. It is possible to attach a disk to "SYSTEM" and attach the same 
disk to a user without first detaching the disk if the disk was not 
accessed while it was attached to the system. 

2. A 370x cannot be used by VM/370 as a 370x unless it has been loaded 
by VM/370, DOS/VS or OS/VS with 270x EP program and VM/370 was 
generated with it specified as a 2701, 2702, or 2703. The ATTACH 
and DETACH commands reset the "loaded" status. 

3. The ATTACH command should not be issued for a 370x in PEP mode 
unless all emulator lines have been disabled by the DISABLE 
command. 

4. If the device being attached is a 2305 then both the real device 
address and the virtual device address must be specified as the 
first exposure on the 2305 (that is, device address or 8) . When 
attaching or detaching a dedicated 2305 to a user, all eight 
exposures are processed. 

5. If the virtual machine to which the device is being attached has 
the ECMODE option, any address up to X'FFF 1 is valid as •vaddr 1 ; 
otherwise, any address up to X*5FF' is valid. 

6. The hexadecimal address of the virtual device (vaddr) that is 
mapped to the real device must be selected with care so that 
conflict and contention caused by control unit I/O interface 
protocol is avoided. Omitting this parameter causes the assigning 
of the raddr as a default. 
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The following is an example of ATTACH statements that can cause 
operational conflict. 

att 10f to jones as 20c <10f is a real 3211) 

att 20e to jones as 20d (20e is a real 3277 terminal) 

In the above example, the virtual addresses of both the 3211 and 
the graphic device indicate the use of the same channel and control 
unit- By definition, the devices are virtual and therefore will 
share one common virtual control unit (VCDBLOK) in CP. 

The real 3211 printer operates on a nonshared subchannel, and the 
real 3270 device is designed for shared subchannel operations. 
Both of these real devices are mapped to the same VCDBLOK. Thus, 
the subsequent processing of a channel program can result in a hung 
or busy condition (caused by a conflict in virtual-to-real I/O 
control procedures) . 

Therefore, when defining devices, make sure the devices are defined 
(and separated) within their own control unit range. 

Note: This same type of virtual device addressing conflict can 
occur with the use of any command or process that alters virtual 
address (es) in the user's VM/370 directory entry. 

If a device containing minidisks is mounted and readied after 
VM/370 has been loaded onto the system, the system operator must 
attach the device to the system. Subsequent logon operations by 
virtual machines can link to this disk if provided by their 
directory entry. Users who had been previously logged on to VM/370 
(who possess a directory entry for the minidisk) must issue, 
subsequent to the DASD attach operation by the system operator, the 
LINK command for access to the device. 

7. When multiple devices or a range of real devices are specified on 
the ATTACH command line and the syntax is correct, all real device 
addresses on the command are processed regardless of whether errors 
are encountered when attempting to attach these devices. 
Therefore, if the following command was issued 

attach 108-1 OF userl r 

and real devices 10A and 10D were not ready and online, the 
following devices would be successfully attached 

108,109 10B,10C, 10E,10F 

Informational messages inform the operator of those devices that 
were successfully attached. Error messages identify the devices 
that are not successfully attached. 

8. To avoid the repetitious attachment of many devices to a virtual 
machine, it might be to the user's advantage to have these devices 
attached to his virtual machine via the DIBECTOBY DEDICATE 
statement. Thus, by fulfilling logon requirements, these devices 
(if online) are automatically attached to the virtual machine. 
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In the case of virtual DASD volumes associated with the 3850 Mass 
Storage System, the ATTACH command allows 3330V devices to be 
attached to a virtual machine without requiring a volume to be 
mounted. This is necessary because staging of cylinder on a 
virtual volume is not accomplished until a MSC mount order is 
issued associating the virtual unit address with a volume serial. 
Even if the mount order was issued prior to the ATTACH, the host 
system may change the data staged on a virtual volume by issuing 
another MSC mount order. 

9. If R/O is specified with a range of addresses cr with multiple 
addresses, this operand applies only to DASD addresses. The R/O 
operand is ignored for all other device addresses specified on the 
command line. 

10. Do not attach virtual 3330 volumes (33307) to the SYSTEM; 3330V 
cannot be used for minidisks, CP residence, paging, or spooling 
activity. 



Responses 



Messages are sent to the user, the operator who issued the command (if 
different from the user), and the primary system operator (if different 
from the operator who issued the command) , notifying them that the 
ATTACH was successful. 

type raddr ATTACHED 
raddr... ATTACHED 
raddr-raddr ATTACHED 

Depending upon the form used for the coimand line, the appropriate 
message indicates to the user the real device or devices attached 
to his virtual machine. If multiple addresses or a range of 
addresses are specified, the device type is not displayed. 

type raddr ATTACHED TO userid vaddr 
type raddr ATTACHED TO SYSTEM volid 
raddr... ATTACHED TO userid 
raddr-raddr ATTACHED TO userid 

Depending on the form used by the class B operator for command line 
entry, the appropriate response indicates the real device (s) that 
are attached to CP or a specified user's virtual machine (and, if 
appropriate, the virtual address of the device) . If multiple 
addresses or a range of addresses are specified, the device type is 
not displayed. 

type raddr ATTACH TO SYSTEM volid BY userid 

— or — 

type raddr ATTACH TO userid vaddr BY userid 

is the response to the primary system operator (if he did not issue 
the coimand) indicating that the real device has been attached 
either to the specified user's machine at virtual address vaddr or 
to the CP system by the specified class B user. 
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Note: In the above responses, "type" is one of the following 

T2£e Meaning 

DASD Direct access storage device 

TAPE Magnetic tape 

LINE Communication line 

RDR Card reader 

PRT Line printer 

PON Card punch 

GRAF Graphics device 

CONS Console 

CTCA Channel-to-channel adapter 

CTLR 3704 or 3705 Communications Controller 

DEV Any other device 
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ATTACH CHANNEL 

Privilege Class: B 

Use the ATTACH CHANNEL command to dedicate all devices on a particular 
channel to a specified user. The addresses by which the virtual machine 
user refers to these devices must be the same as the real addresses (he 
cannot use minidisks) . You do not have to attach the devices 
individually on the attached channel to the specified virtual machine 
user; he may use any or all of the devices. However, whether idle or 
not, you cannot attach the devices on the channel to another user. The 
virtual machine must have all I/O stopped before executing the command. 
The format of the ATTACH CHANNEL command is: 



i 1 

I I r n I 

I ATTach I CHANnel c [To] |userid| I 

II I* I I 

I I L J I 

i 1 

wh ere : 

CHANNEL c 

is the real address of the channel to be attached to the user. 
CHANNEL is a required reserved word. 

r t 

TO | user id | 

I* I 

L J 

is the user identification of the virtual machine that is to 
use the dedicated channel. The user must be logged on in 
order to get control of the channel. The user id can be 
specified as an asterisk (*) to indicate that the channel is 
to be attached to the virtual machine of the class B user 
issuing the command. If the optional keyword TO is omitted, 
the userid cannot be TO or T. 

Note: A DETACH CHANNEL command followed immediately by an ATTACH CHANNEL 
command may result in a message stating that the specified channel is in 
use. DETACH CHANNEL processing causes I/O to be asynchronously 
scheduled for each dedicated device; DETACH CHANNEL processing does not 
wait for all I/O to complete prior to returning control to the terminal 
operator. A subsequent ATTACH CHANNEL command may fail due to this 
timing situation. 

Responses 

CP sends messages to the user*s terminal on the virtual machine to which 
the channel is attached, and to the operator who issued the command. 

CHANNEL C ATTACHED 

is the response to the user who receives dedicated access to the 
channel. 
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CHANNEL c ATTACH TO userid 

is the response to the operator who issued the command. 

CHANNEL c ATTACH TO userid BY operator 

is the response to the primary system operator if someone else 
issued the command. 
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AUTOLOG 

Privilege Class: A or B 

Dse the AOTOLOG command to log on any virtual machine that is defined in 
the ¥8/370 directory. 

The virtual machine logged on operates in disconnect node. The 
virtual aachine being logged on with the AOTOLOG coaaand Bust have an 
autoaatic IPL defined in its directory and is allowed to issue one read 
to its virtual console. The saae restraints that apply to any 
disconnected aachine also apply to virtual machines logged on with the 
AOTOLOG coaaand. The format of the AOTOLOG coaaand is: 

i ! : 1 

I AOTOLOG | userid password [ variable data ] I 

I : _ 1 



w her e: 

userid is the user identification of the virtual machine to be logged 
on. 

password is the password for the virtual machine to be logged on. 

variable data 

is the inforaation that is passed to the virtual aachine when 
a virtual SIO is issued to the virtual aachine's console. Op 
to 108 bytes of data Bay be placed in this field. If no 
variable data is entered, the field is padded with blanks. 
Hote, eabedded line-edit characters in this file are treated 
as data. 

O sage Botes: 

1. AOTOLOG is automatically invoked after VH/370 initialization if the 
7M/370 directory contains a userid of AUTOLOG 1. Then, with a 
suitable PROFILE EXEC, other virtual machines can be logged on and 
brought online (for ezaaple, the batch virtual aachine) . 

2. If LOGOS journaling is not being used, and an AOTOLOG command that 

includes a password is issued from a virtual machine, CP determines 
if the password is correct. If the password is incorrect, a count 
of such incorrect passwords is maintained by CP. When a total of 
four incorrect passwords have been entered, an error message is 
issued and the AOTOLOG command from the virtual machine is 
disallowed. AOTOLOG can still be issued directly from the terminal 
(that is, in CP console mode) . 

3. If LOGOH journaling is OH, the count of incorrect passwords is 
incremented without regard to the origin of the command. When the 
installation defined limit of invalid AOTOLOG passwords is reached, 
(as specified in the SYSJRL macro of DMKSYS) AOTOLOG is disallowed 
regardless of how it is entered. 

1. If password suppression has been generated, the password may be 
included on the command line only if the AUTOLOG command is in an 
EXEC or HODOLE running under CHS. Otherwise, all data following 
userid is assumed to be variable data and the password is read from 
the teriinal. 
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Responses 

hh:mm:ss AUTO LOGON *** userid OSERS=nnn BY ( SYSTEM ) 

( userid2 J 

is the response to the system operator upon successful issuance of the 
AUTOLOG command. 

w he re; 

*** indicates no assigned line address for the virtual console. 

userid is the identification of the virtual machine initiated by 
ADTOLOG. 

OSERS=nnn is the number of logged-on users. 

SYSTEM indicates that the ADTOLOG process is part of VH/370 system 

initialization. 
userid2 identifies the virtual machine that invoked the ADTOLOG 

command. 
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BACKSPAC 



Pr ivil ege Class: D 



Ose the BACKSPAC com nand to restart or reposition the current output on 
a real punch or printer. If the BACKSPAC command is issued while an 
intervention required condition is pending on the printer or punch, the 
interrupted channel program is terminated and the backspace is 
performed. The format of the BACKSPAC command is: 



Printer BACKSPAC Format 

, j 

I r i I 

BAckspac | raddr |File | | 

I | pages [EOF]| | 

I II II 

I L J I 

1 



Punch BACKSPAC Format 



I 
BAckspac | raddr [File] 

I 
I 



w here : 
raddr 

FILE 
pages 

I EOF 
I 



is the address (cuu) of the real unit record device that is to 
be backspaced. This address must be that of a punch or a 
printer. 

specifies that the output spool printer or punch file is to be 
restarted from the beginning. 

specifies the number of pages to be backspaced on the printer. 
If the field is not specified, the printer is backspaced to 
the beginning of the page being printed when the command is 
received. 

specifies that printing is to resume from the end of the spool 
file. Backspacing occurs the requested number of pages from 
the end of the spool file. Printing is restarted at this 
location. 



Osa ge Botes : 



Pages for backspacing are counted starting from the end of the 
current spooling buffer. Output containing a small number of lines 
per page may require a count of more than one to backspace one 
page. 

Pages are counted in BACKSPAC operations by looking for skip to 
channel 1 specifications (page ejects) . If a file does not contain 
skip to channel 1 specifications, processing of the file is 
restarted regardless of the number of pages indicated. Counting 
begins at the end of the current buffer. 
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Responses 

(PRT) raadr B1CKSPACE userid FILE = file RECDS = norecs COPY = nn a typ 
iPONj 

where; 

raddr is the real device address. 

userid is the identification of the user whose file was active and 
backspaced. 

file is the unique, system-assigned spoolid number by which VH/370 
refers to the file. 

norecs is the total number of logical records in the file. 

nn is the remaining nuiber of copies of the file to be created, 
where 01 is the last copy. 

a is the spool file class. 

typ is the originating device type, PRT, CCU, or PUH. 



Section 3. CP Commands 55 



CHANGE 



Privilege Class: 



Ose the CHANGE command to alter one or more of the external attributes 
of a closed spool file or files. The current attributes of a file may 
be determined by issuing a QUERY command. In order to change an output 
file, the file must have been closed but not yet selected for printing 
or punching. An input (READER) file may be changed at any time before 
it is opened, that is, before the first read is issued for the file. 
The format of the CHANGE command is: 



CHange 



Reader 



POnch 



CLass d 

spoolid 

ALL 

CLass d 

spoolid 
ALL 



r i 
|userid| 
ISYSTEM 



{CLass c1 
spoolid 
ALL 



CLass c2 



/CLass c2 
COpy nn 

r t 

IHOld | 
|NOHold| 

L J 

lDIst distcode 

r t 
| SYS | 
INOSYSI 

,L J 



"CLass c2 
copy [*] nn 

r n 

IHOld | 
|NOHold| 

L J 

DIst distcode 



y.SYS | 

\ INOSYSI 



r t 

IFLash name nn | 
ICHars name | 
IHOdify name | 
IFCB name | 



f[NAme{fn[ft]}] 
[ {dsname}] 



*One of these options must be chosen; however, more than one may be 
specified and they may be combined in any order. 



where: 
userid 



is the user identification for the user whose spool files are 
to be changed by the spooling operator. 



SYSTES allows the spooling operator to 
the system regardless of userid. 



manipulate all spool files i 
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READER indicates that reader files are to be changed. 

RDR 

PRINTER indicates that printer files are to be changed. 
PRT 

PUNCH indicates that punch files are to be changed. 
PCH 

CLASS d designates an existing class. "c1" is a one-character 
alphameric field from 1 to Z, to 9 or *. 

spoolid is spoolid number of the file that is to be changed. Each 
file has a unique spoolid. 

ALL changes all files belonging to the user. 

CLASS c2 designates the new class of the file. 

HOLD prevents the printing, punching, or reading of a file by 
putting it in a user HOLD status until released by the NOHOLD 
operand. 

NOHOLD releases the specified spool file currently held by the user 
HOLD status. 

DIST distcode 

changes the distribution code of the file, "distcode" is a 
one to eight character alphameric identification that appears 
on the output separator of printer or punch output instead of 
the identification specified in the VH/370 directory. The 
distribution code is changed for this file only, and does not 
affect other files nor change the normal user code. 

SYS prevents the printing or punching of the file by putting it in 
a system hold status until released by using NOSYS. 

NOSYS releases the specified spool file currently being held by a 
system hold status. 



ffn 
\dsi 



Note; A system hold has no effect on the processing of reader 
files. 

NAME /fn [ft]! 
;name / 

changes the name of the file. For CHS files, the specified 
filename (and, optionally, filetype) become the nev file 
identification. For a non-CMS file, the specified dsname (a 1 
to 24-character field) becomes the new file identification. 

Note: If the NAME function is selected and only fn is 
specified, ft is set to blanks. The dsname specification 
allows a user to specify a file name suitable for OS such as 
SYS1.SYSLIB.MYMAC. 

FLASH name nn 

specifies the flashing status of the file. The name 

identifies a forms overlay sheet contained in the 3800 

printer. Name may be varied from one-to-four characters. The 

number nn, specifies the number of copies to be flashed. This 
flash count may range from 00 to 99. A flash count of zero is 
the default, which indicates flashing is not desired. 
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I2£e: The FLASH naae must Batch the FLASH name specified by 
the YM operator in the START command, unless the flash count 
is zero, in which case the file match is found by class of 
file only. 

CHARS name 

is the name of the character arrangement table used for 
printing the file. Name may be from one-to-four characters in 
length. If a character arrangement table is not specified for 
a file, the default table used for the separator page on the 
selected printer will be used to print the file. 1 

MODIFY name 

is the name of the copy modification module used for printing 
the file. Name may be from one-to-four characters in length. 
If not specified, copy modification will not be used for 
printing the file. 1 

FCB name is the name of the forms control buffer used for printing the 
file. Name may be from one-to-four characters in length, or 
the unique numbers 6, 8, or 12. These specifications mean: 
print the entire spool file at 6, 8, or 12 lines per inch, 
regardless of the size of the paper that is currently loaded. 
Use of the unique numbers will never cause an FCB-forms 
mismatch. If not specified, the value specified for the 
separator page in the START command is used. 1 



COPY [*] nn 
COPY nn 



alters the number of copies for the file. The value of nn 
(number of copies) must be a number from 1 through 99. For nn 
less than ten, the leading zero is optional. When the COPY 
parameter includes an asterisk, the file is transmitted to the 
3800 printer only once. The 3800 performs the duplication 
internally one page at a time. (For example, if C0PY*3 is 
specified, the page numbers are copied as 111 222 333 ...). 
Otherwise, the file is transmitted once for each copy desired, 
with VM/370 indicating the copy number to the 3800. 



Res p o nses 



/nnnn) FILES CHANGED 
\ NO / 



is the response to the user who issued the CHANGE command. 

This response is suppressed if the virtual machine user has 
issued the SET IHSG OFF command. The system operator monitoring 
the RSCS virtual machine for his installation should not specify 
this option because information messages are required for 
accurate monitoring of RSCS system activity. 

Note: Depending upon the options chosen and the combinations 
used, the actual "changing" of some files may not have occurred 
because they had the new class prior to issuing the CHANGE 
command. The response is an indication of the number of 
referenced files. 



I _ 

I *A specification of NULL will nullify any previous setting 
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DCP 



Privilege Classes: C or E 



Use 'the DCP command to display the contents of real storage locations at 
the terminal. In attached processor system configurations, the values 
of PSA for the main and the attached processor can also be disclosed. 

If an invalid operand is entered, the DCP command terminates. 
However, any previous valid operands are processed before termination 
occurs- The format of the DCP command is: 



DCP 



r i 

MLhexlod 

NLhexlod 

MThexlod 

NThexlod 

Mhexlod 

Nhexlod 

Lhexlod 

Thexlod 

hexloc 1 



r t 

- ) | hexloc2 | 
END | 



{;} 



{ . }|bytecount J 

L J J 



where: 



MLhexlod 

NLhexlod 

MThexlod 

NThexlod 

Mhexlod 

Mhexlod 

Lhexlod 

Thexlod 

hexlod 





specifies the first storage location to be displayed. If 
hexlod is the only operand, it specifies the only storage 
location to be displayed. If hexlod is not specified, L or T 
must be specified, and the display begins with storage 
location 0. If hexlod is specified and L or T is not 
specified, the display is in hexadecimal. T specifies that an 
EBCDIC translation is to be included with the hexadecimal 
display. L specifies that the display is to be in hexadecimal 
only. If hexlod is followed by a period and is not on a 
fullword boundary, it is rounded down to the next lower 
fullword. 



In attached processor systems, H specifies that the addresses 
are interpreted as though the main processor generated them. 
Thus, MO refers to location of the PSA of the main 
processor. The N prefix specifies that the addresses be 
interpreted as though the attached processor generated them. 
The absence of H or N results in the address being interpreted 
as an absolute address. N is valid only if the attached 
processor is operational. M is valid if the system has been 
generated for attached processors. The prefix M or N is not 
meaningful for uniprocessor systems. 
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{:} 



r i 
|hexloc2| 
I END | 



specifies that a range of locations is to be displayed. To 
display the contents of one or more storage locations by 
specified storage address location the H=w or «:« Bust be 
used. The hexloc2 operand must be 1- to 6-hexadeciaal digits; 
leading zeros need not be specified. In addition. The hexloc2 
operand aust be equal to hexlod and it should not exceed the 
size of real storage. If END is specified, real storage froa 
hexlod through the end of real storage is displayed. If 
hexloc2 is not specified, END is the default. Note that this 
occurs only if a dash (-) or a colon (:) follows the first 
operand. 



r t 

{ . }|bytecount| 

I END | 

L J 

is a hexadeciaal integer designating the number of bytes of 
real storage (starting with the byte at hexlod) to be 
displayed on the terminal. The sum of hexlod and the 
bytecount must be an address that does not exceed the size of 
real storage. If this address is not on a fullword boundary, 
it is rounded up to the next higher fullword. The bytecount 
operand must be a value of 1 or greater and may not exceed six 
hexadecimal digits. 

Dsaqe Notes: 

1. Normally, a user defines or should define the beginning and ending 
locations of storage in the following manner: 

dcp Lhexloc1-hexloc2 

dcp Thexloc1-hexloc2 

dcp hexlod: hexloc2 

dcp hexlod. bytecount 

dcp hexlod :hexloc2 hexlod .bytecount 

Blanks must not be entered between the limit or range symbols (: or 
- or .) or any of the operands except for the blank or blanks 
between the coaaand name and the first operand. A blank is also 
required between each set of operands when aore than one set of 
operands are entered on one command line. 

However, if a blank immediately follows the designated type 
character (T or L) , DCP displays all of real storage. If the next 
operand is either a colon (:), a dash (-) , or a period (.) followed 
by a blank character, the system again defaults to a display of all 
storage locations as this operand assumes a second set of operands. 

2. Blanks separate operands or sets of operands if more than one 
operand is entered on the same command line. Blanks should not 
occur on the right or left of range or length symbols, unless it is 
intended to take the default value of the missing operand defined 
by the blank. 
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The following are examples of DCP entries that produce fall storage 
displays. 



dcp 1 


dcp 1- 


dcp 0- 


dcp t:end 


dcp t 


dcp 1: 


dcp 0: 


dcp t:end 


dcp - 


dcp t: 


dcp 1-end 


dcp 0:end 


dcp : 


dcp 1. 


dcp t-end 


dcp Lend 


dcp . 


dcp t. 


dcp 0-end 


dcp O.end 



The following displays all of storage three times because of the 
embedded blanks: 

dcp 1 . t 

For default values (that is, the beginning and ending of storage) 
to be applicable, one operand must be specified. 

3. In attached processor applications, the PSA values for the main and 
the attached processor are not located at absolute page 2ero but 
are displacements from it. Therefore, prefixing the hexadecimal 
location with an H or N will add the hexadecimal value to the 
displacement of the location of the assigned PSA for the designated 
processor; for example, 

dcp m40.8 Displays the CSW of the main processor. 

dcp n78-7f Displays the I/O new PSW of the attached processor. 

Responses 

Reguested locations are displayed in the following format: 

xxxxxx = wordl word2 word3 wordU [key] *EBCDIC translation* 

where: 

xxxxxx is the real storage location of wordl. 

wordl is displayed (word-aligned) for a single hexadecimal 
specification. Op to four words are displayed on a line. If 
required, multiple lines are displayed. 

EBCDIC translation 

is displayed aligned to the next lower 16-byte boundary if 
Thexloc is specified. Note that nonprintable characters are 
displayed as a period (.) . If the location is at a 2K page 
boundary, the key for that page is also displayed. The output 
can be stopped and the command terminated by pressing the ATTH 
key (or its equivalent) . 
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DEFINE 



Pr ivi lege Class; B 

Dse the DEFINE command to redefine the status of a 3330V voluae. For 
example, a 3330T may have been defined as VIRTUAL allowing it to be 
dedicated to a specific virtual aachine. However, if that virtual 
■achine is not logged on, you can redefine the 3330V as SYSVIRT to make 
it available to the control program for aounting system volumes. The 
format of the DEFINE command is: 



I DEFine | 



j Sysvirt) 
( Virtual/ 



raddrl [-raddr2] 



where; 

SYSVIRT specifies the desired status of the 3330V. This status is 
reserved for CP. VH/370 system volumes that are MSS 3330V 
volumes can be mounted on SYSVIRT 3330V devices. 

VIRTUAL specifies the desired status of the 3330V. 3330V devices that 
are dedicated or attached must use the VIRTUAL feature. 

raddrl [-raddr2] 

specifies the device address or range of addresses to be 
defined. If a range is specified, all 3330V devices in the 
range are set to the desired status. 

U sage Notes: 

If an MSS volume is mounted and not currently in use on a 3330V that is 
redefined, the control program cuases the volume to be demounted before 
the DEFINE command completes. An MSS volume demount should be forced to 
redefine the status of the 3330V on which the volume is mounted. 



Responses are sent to the operator who issued the DEFINE command. The 
responses show the device status following execution of the command. 
Possible responses are: 



raddr NOT KNOWN 

The raddr is not a valid device address, 
the raddr. 



No action is taken for 



raddr NOT 3330V 

The raddr is not a 3330V. No action is taken for the raddr. 

raddr ALREADY SYSVIRT 
raddr ALREADY VIRTUAL 

The raddr already has the status to which it is to be defined. It 

is left in its current status. 

raddr IS CURRENTLY DEDICATED 

The raddr is currently dedicated to a virtual aachine. The status 
is not changed from VIRTUAL to SYSVIRT. 
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radar IS OFFLINE. DEFINE WILL BE DONE. 

The radar is currently offline. When it is varied online, it will 
receive the status specified in the command. 

raddr IN USE BY SYSTEM 

The raddr is currently attached to the system and there is at least 
one user minidisk allocated on the volume. The raddr cannot be 
defined as VIRTUAL. 

raddr HAS A HOONTED VOL. MSS ID NOT AVAILBLE TO DEMOUNT IT 

There is a 33307 volume mounted on the raddr. The HSS communicator 
is not active and the volume cannot be demounted. The status of 
the raddr is not changed. 

raddr - ERROR DEMOUNTING VOLUME 

There is a 3330V volume mounted on the raddr. The control program 
attempted to demount the volume, but MSS encountered an error. The 
volume is not demounted and the status of the raddr is not changed. 

INVALID RANGE 

A range of address (raddrl - raddr2) was specified. Either raddrl 
or raddr2 does not exist or is not a 3330V. Status is not changed. 

raddr DEFINED AS VIRTUAL 

raddr DEFINED AS SISVIRT 
i The raddr has been given the specified status. If a volume was 
I previously mounted on the raddr, it is now demounted. 



Section 3. CP Commands 63 



DETACH 

Privilege Class: B 

Use the DETACH command to remove a real device from the CP system. 
Volumes in the SYSOWN list, or devices containing minidisks that are in 
use, cannot be detached. Tape devices are automatically rewound and 
unloaded when detached. A previously attached device can be detached 
from a user even if the device is still in use. For devices that were 
attached by an ATTACH command and then detached by the user, a message 
is sent to the operator informing him that the device is free. The 
format of the DETACH command is: 



I DETach I f raddr ] [From] (userid) I 

I | {raddr... > {SYSTEM) 1 

I | (raddr-raddr) ( * ) I 

l ; 1 

w her e: 

(raddr ) 

{raddr... S 

( raddr-raddr) 

specifies the real address (cuu) , multiple addresses or range 
of addresses of the device or devices to be detached. 

FROM ( userid} 

I SYSTEM ) 

specifies the user identification of the virtual machine to 
which the real device [raddr] is currently attached. If the 
optional keyword FROM is omitted, the userid cannot be FROH, 
FRO, FR or F. If the DETACH command is invoked to detach a 
device from the class B operator's own virtual machine, an 
asterisk [*] may be used. SYSTEM indicates that the device is 
a DASD device in use by CP for allocation and control. 
When specifying a userid that could also be a valid 
hexadecimal device address (for example, virtual machine id 
CE) , the FROM operand must be specified to distinguish it as a 
userid. 

Usage Notes: 

1. A 370x cannot be used by VM/370 as a 370x unless it has has been 
loaded by YM/370, DOS/VS, or OS/VS with 270x EP program and VM/370 
was generated with it specified as a 2701, 2702, or 2703. The 
DETACH command resets the "loaded" status. 

2. If the device being attached is a 2305, then both the real device 
address and the virtual device address must be specified as the 
first exposure on the 2305 (that is, device address or 8) . When 
attaching or detaching a dedicated 2305 to a user, all eight 
exposures are processed. 

3. When multiple addresses or a range of addresses are specified on 
the DETACH command line, then the affirmative response are issued 
for devices that were successfully detached. Error messages are 
issued for devices that cannot be detached. 
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4. Attempts to detach an active shared device from the system will 
result in an error message indicating the device is being shared by 
multiple users. In order to detach the device, the system operator 
must inform the affected users to detach the device from their 
virtual systems. The QUERY LINKS commands used by the system 
operator will inform him of the progress of the virtual machine 
detachment operation. 

5. DOS or OS virtual machine systems should vary the device offline 
before invoking the DETACH command. Similarly, CHS users should 
issue the RELEASE command before invoking DETACH. 

6. The use of DETACH while a virtual machine is tracing I/O will cause 
abnormal termination, (DSPQQ4). 

Responses 

Messages are sent to the user, the operator who issued the command, 
and the primary system operator (if different from the operator who 
issued the command) , notifying them that the DETACH was successful. 

{Vaddr... ) 
vaddr-vaddr > 
type vaddr ) DETACHED BY operator 

the appropriate response sent to the user if an operator detaches 
one or more of the user*s devices. 

(raddr... J 

^raddr-raddr > r t 

(type raddr ) DETACHED juseridj 

| SYSTEM | 

L J 

the appropriate response is issued if the user detaches a 
previously attached device (s) or if the operator detaches the 
device (s) from a user or the system. 

{raddr... j 
raddr-raddr > r n 

type raddr ) DETACHED juseridj BY operator 

| SYSTEM | 

L J 

the appropriate response is issued to the primary system operator 

if a class B operator other than the primary system operator issued 

the DETACH command and the device or devices had been previously 
attached. 

Note : In the above responses (other than multiple real address response 
or a range of real address responses) , the term "type" is one of the 
following: 

Typ e Meaning 

DASD Direct access storage device/3330V (MSS 3330 virtual volume) 

TAPE Magnetic tape 

LINE Communication line 

RDR Card reader 

PRT Line printer 

PUN Card punch 

GRAF Graphics device 

CONS Console 

CTCA Channel-to-channel adapter 

CTLR 3704 or 3705 communications controller 

DEV Any other device 

MSC 3151 port address 
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CTCA vaddr DROP FROM userid vaddr 

is the response if the device detached was a virtual CTCA connected 
(via the COUPLE command) to another CTCA on the virtual machine 
specified by the userid. This response is always followed by the 
response: 

CTCA vaddr DETACHED 
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DETACH CHANNEL 



Privilege Class: B 



Use the DETACH CHANNEL command to detach a dedicated channel from a user 
when the channel path is no longer required for virtual machine 
operations. If DETACH CHANNEL is issued prior to the normal completion 
of I/O activities on the dedicated channel path, those activities are 
terminated. The format of the DETACH CHANNEL command is: 



DETach | CHANnel c [From] f userid) 
I I * / 



where: 
CHANNEL c 



is the real address of the channel that is to be detached. 



FROH ( userid \ 



* i 

specifies the user identification of the virtual machine from 
which the channel is to be detached. If the optional keyword 
FROH is omitted, the userid cannot be FROM, FRO, FR, or F. If 
the DETACH CHANNEL command is invoked by a class B user to 
detach a channel from his own machine, an asterisk (*) may be 
used. 



Note: A DETACH CHANNEL command followed 
ATTACH CHANNEL command may result in a me 
the specified channel is in use. DETACH 
causes I/O to be asynchronously scheduled 
device; DETACH CHANNEL processing does not 
complete prior to returning control to the 
A subsequent ATTACH CHANNEL command may 
timing situation. 



immediately by an 
ssage stating that 

CHANNEL processing 
for each dedicated 
wait for all I/O to 

terminal operator. 

fail due to this 



Responses 



CHANNEL c DETACHED BY operator 

is sent to the user from 
being detached. 



whose virtual machine the channel is 



CHANNEL c DETACHED userid 

is sent to the operator issuing the command. 

CHANNEL c DETACHED userid BY operator 

is sent to the primary system operator if he did not issue the 
command. 
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DISABLE 

Privilege Classes: A or B 

Dse the DISABLE command to prevent low-speed communication lines, 
including 2701, 2702, and 2703 lines (collectively referred to as 270x 
lines), 370x facilities (in Eiulation Frograa scde only), and locally 
attached 3270 lines from accessing the VM/370 system. 

Note: The remote 3270 configuration must be disabled by using the 
DISABLE operand with the NETWORK command. 

To disable 370x resources in NCP or PEP program mode, use the NETWORK 
DISABLE command. If the line(s) selected are not active (not dialed 
into or logged on) , the line is disabled immediately. If the selected 
line is active, it is disabled when the user does a LOGOFF to finish his 
terminal session or issues a DISCONN command without the HOLD operand 
specified. An ENABLE command issued to the line before the line is 
physically disabled reinstates the enabled status, thus negating the 
DISABLE command. The format of the DISABLE command is: 



I DISAble | fraddr...) I 

I I (ALL { I 

i 1 



where: 

raddr... are the address (es) (cuu) of any communication lines the 
operator wishes to disable. 

ALL specifies that all 270x communication lines, 370x facilities 
in Emulation Program mode only) , and locally attached 3270 
lines, including the operator's line, are to be disabled. 



Note: Issuing a QUERY LINES and NETWORK QUERY command enables you to 
examine the status of the communication lines. 



Line designations may indicate up to 2700 line addresses. These 
three-digit hexadecimal addresses are checked against the line addresses 
stored in the system table. If no match is found, an error message is 
directed to the system consols. 

Responses 

COMMAND COMPLETE 
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DMCP 



Privilege Classes: C or E 



Use the DMCP command to print the contents of real storage locations on 
the user's virtual spooled printer. The output format is eight words 
per line with EBCDIC translation. Multiple storage locations and ranges 
■ay be specified. In a system running with an attached processor, 
values that are displacements from the assigned locations of the Prefix 
Storage Area (PSA) of the main or attached processor can also be dumped. 
To get the output printed on the real printer, the virtual spooled 
printer must be terminated with a CLOSE command. The format of the DMCP 
command is: 



DMCP 



r i 

MLhexlod 

NLhexloc 1 

MThexlod 

NThexlod 

Mhexloc 1 

Nhexloc 1 

Lhexlod 

Thexiod 

hexlod 



j 



r t 

hexloc2 | 



f-\| hex 
l:|l IND 



r t 

{ . }|bytecount | 
I END I 



[♦dumpid] 



j j 



where: 

MLhexlod 

NLhexlod 

MThexlod 

NThexlod 

Mhexlod 

Nhexlod 

Lhexlod 

Thexiod 

hexlod 





specifies the first storage location to be dumped. If hexlod 
is the only operand, it specifies the only storage location to 
be dumped. If hexlod is not specified, L or T must be 
specified and dumping starts with storage location 0. An 
EBCDIC translation is included with the dump contents. If 
hexlod is followed by a period and is not on a fullword 
boundary, it is rounded down to the next lower fullword. 

In attached processor systems, M specifies that addresses be 
interpreted as if the main processor generated them. Thus, MO 
refers to location of the PSA of the main processor. The N 
operand specifies that addresses be interpreted as if the 
attached processor generated them. The absence of H or N 
results in * the address being interpreted as an absolute 
address. N is valid only if the attached processor is 
operational. M is valid if the system has been generated for 
an attached processor. The prefixes M or N are not meaningful 
for a uniprocessor generated system. 
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r t 

-\ |hexloc2| 

END I 



{ = } 



is a range of real storage locations to be dumped. To dump to 
the end of real storage, hexloc2 may be specified as END or 
not specified at all, in which case END is assumed by default. 

r i 

{ . }|bytecount I 

| END | 

L J 

is a hexadecimal integer designating the number of bytes of 
real storage (starting with the byte at hexlod) to be typed 
at the printer. The sum of hexlod and the bytecount must be 
an address that does not exceed the size of real storage. If 
this address is not on a fullword boundary, it is rounded up 
to the next higher fullword. If the "." is used for a range, 
hexloc2 is defined as the number of hexadecimal storage 
locations (in bytes) to be dumped starting at hexlod. If 
hexloc2 is specified as a length in this way, it must have a 
value such that when added to hexlod it will not exceed the 
storage size. 

♦dumpid is specified for identification purposes. If specified, it 
becomes the first line printed preceding the dump data. Dp to 
100 characters with or without blanks may be specified after 
the asterisk prefix. If dumpid is specified, hexloc2 or 
bytecount must be specified. The asterisk (*) is required to 
identify the dumpid. 

Osage N ote s: 

1. Normally, a user defines beginning and ending dump locations in the 
following manner: 

dmcp Lhexloc-hexloc 

— or — 

dmcp hexloc. bytecount 



There must not be any blanks between length or range symbols (: or 
-or .) or between any of the operands except for the blank (s) 
between the command and the first operand. A blank is also 
required between each set of operands when more than one set of 
operands are entered. Note that only one period (.) , colon (:), 
dash (-) or no delimiter may be used within each set of operands. 

If, however, a blank immediately follows the designated type 
character, the default dump starting and ending locations are 
assumed to be the beginning and/or end of virtual storage. 
Similarly, if the range or length symbol separates the first 
character from a blank or END, all of real storage is dumped. 

Blanks separate operands or sets of operands if more than one 
operand is entered on the same command line. Blanks should not 
occur on the right or left of the range or length symbol, unless it 
is intended to take the default value of the missing operand 
defined by the blank. Thus, all of the following produce full 
storage dumps. 
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dmcp 1 


dncp 1— 


dncp t. 


dncp t— end 


dmcp t 


dmcp t- 


dncp 0- 


dncp 0:end 


dmcp - 


dicp 1: 


dncp 0: 


dncp Lend 


dicp : 


dmcp t: 


dncp 0. 


dncp O.end 


dncp , 


dncp 1. 


dncp 1-end 





Each of the following produces three full dumps because of the 
enbedded blanks: 

dncp 1 . t 
dncp - : . 

3- In cases where multiple storage ranges or linits are specified on 
one connand line and the line contains errors, connand execution 
successfully processes all correct operands to the encountered 
error. The encountered error and the renainder of the connand line 
is rejected and an appropriate error nessage is displayed. 

4. For default operand values (the beginning and ending of storage) to 
be applicable, at least one operand nust be specified. 

5. In attached processor applications, the PSA values for the nain and 
the attached processor are not located at absolute page zero but 
are displacenents fron it. Therefore, prefixing the hexadecinal 
location with an M or N will add the hexadecinal value to the 
displacement of the location of the assigned PSA for the designated 
processor; for exanple: 

DHCP n40.8 Dunps the CSV of the main processor 

n78-7f Dunps the I/O new PSW of the attached processor. 

Respon ses 

As the dump proceeds, the following nessage appears at the terninal 
indicating that the dunp is continuing fron the next 64K boundary: 

DUMPING LOC hexloc 

where "hexloc" is the segnent (64K) address for the dunp continuation, 
such as 020000, 030000, 040000. 

If the user signals attention on the terninal while the above nessage 
is displayed, the dump ends. 

COMMAND COMPLETE 

indicates normal completion of the dump. 
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DRAIN 

Privilege Class: D 

Use the DRAIN comoand to stop spooling operations on the specified real 
unit record devices after the file currently being processed has 
completed. This command brings the spooling system or a specified 
.device to a controlled halt, or halts the activities on a device whose 
spooling status is to be changed. For example, all unit record devices 
are usually drained before system shutdown, and a printer must be 
drained before the contents of the OCS printer buffer are changed. 

A device is drained immediately if it is not active when the DRAIN 
command is issued; otherwise, it is drained when processing of the 
current file has completed. A drained device can be restarted by the 
START command. If START is issued to a device before draining is 
complete, the device does not enter the drained status but continues 
processing. The format of the DRAIN command is: 




I Reader 
IPrinter 
IPOnch 
jraddr.. . 
I ALL 

L 



where: 

READER 
RDR 

PRINTER 
PRT 

PUNCH 
PCH 

raddr 



ALL 



drains the reader. 



drains the printer. 



drains the punch. 



drains the real "spooled devices at the specified acTdresses" 
(cuu) . Multiple addresses may be specified. 

drains spooled unit record devices in the system. 



Responses 

The following response occurs for each device that enters the drained 
status. 



/PRT\ 
(PUN / 



raddr DRAINED SYSTEM 



CLASS = a. 



.. / SEP) 
\NOSEP J 



RDR raddr DRAINED SYSTEM 

wh ere : 

raddr is the real device address of the device drained. 

a... are those output classes that the drained device was servicing. 
From one to four classes are displayed for printer or punch 
devices drained. 
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ENABLE 

Privilege Classes: A or B 

Use the ENABLE command to enable the following previously disabled or 
nonenabled devices so users may access the VM/370 system: 

• 3270 (locally attached only) and the 3138, 3148, and 3158 consoles. 

• 2701, 2702, and 2703 (270x> 

• 3704 and 3705 in Emulation Program mode only 

Previously enabled lines are not affected by the ENABLE command. 
This command affects only low speed communication lines with a data rate 
not greater than 600 bps (bits per second) . For 3704/3705 resources 
running in NCP or PEP mode and 3270 remote devices, use the NETWOBK 
ENABLE command. The format of the ENABLE command is: 



I ENable | (raddr...) 
I I I ALL J 



where: 

raddr... are the addresses (cuu) of the lines that are to be enabled. 
If more than one address is specified, each must be separated 
from the others by one or more blanks. 

* 

ALL enables all previously disabled or non-enabled locally 
attached 3270 display terminals and display copy printers 
(3284/3286 etc.), 3704/3705 (Emulation Program mode only), and 
270x lines. 

N otes : Do not attempt to enable terminal devices that are not supported 
as VM/370 virtual machine system consoles. Non-supported console 
devices can only be used as dedicated devices attached to 
multiple-access system virtual machines. 



Response 

COMMAND COMPLETE 

Note: No error indication is provided if no lines are available to be 
enabled. Issue the QUERY LINES command to see how many lines are 
enabled. 
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FLUSH 



Pr ivil ege Class: D 



Use the FLUSH command to halt and immediately purge or, optionally, hold 
.the current output on a specified real unit record device. The device 
resumes activity with the next scheduled spool file. The format of the 
FLUSH command is: 



I Flush 
i 



| raddr [ALL] [Hold] 



where; 
raddr 

ALL 



HOLD 



is the address (cuu) of the real 
whose activity is to be terminated 
or punch) . 



unit record output device 
(that is, the real printer 



deletes all copies of the current output file. If more than 
one copy of the current output file is being printed or 
punched and this option is specified, all copies are deleted; 
if ALL is not specified, only the current copy is deleted and 
the next copy, if any, is printed or punched. 

places the spool file in system hold status. If this option 
is specified, the terminated spool file is not purged, but is 
put in a system hold status and can be reset using the CHANGE 
command. 



Usage N ot e s : 

1. The FLUSH command is usually invoked when it is apparent that a 
mistake in output queuing has occurred, or if a high priority job 
must be started before the current job has finished. For example, 
a file was directed to a printer that is equipped with the wrong 
printer train to process that file, or a file was misdirected to 



the real 
example: 

FLUSH E HO 



punch rather than a user's virtual punch unit. For 



2. Special handling is required if a spool file is started on a real 
output device that cannot be made ready. When such a condition 
arises, an error message is directed to the operator, who can 
recover the file and restart it. To do so, he must enter the 
following commands: 

FLUSH raddr [HOLD] 
DRAIN raddr 

Following the entry of these commands, the "FATAL I/O EBBOB M 
message is issued to the operator and the device is logically 
offline. No attempt is made by the system to use the device until 
the operator puts it back online via the VABI command. 

If HOLD is specified, the file is placed in system hold status; if HOLD 
is not specified, the file is requeued and started on another device (if 
one is available) . Both the FLUSH and DBAIN commands must be issued to 
recover the file. 
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Responses 

i PET \ raddr (FLUSHED ) userid FILE = file RECDS = norecs COPY = nn a typ 
(PON/ (FILE HELD/ 

The FILE HELD response is given in addition to the FLUSHED response if 
the HOLD option is specified. 

wh er e: 

raddr is the real address of the printer or punch to be affected. 

userid is the identification of the user who is to receive the 
output. 

file is the unique spoolid number which identifies the file to the 
VM/370 system. 

norecs is the total number of logical records in the file. 

nn is the number of copies remaining for the file, where 01 is 
the last copy. 

a is the spool file class. 

typ is the originating device type (PRT, CON, or PON) . 



Section 3. CP Commands 75 



FORCE 

Privilege Class: A 

Ose the FORCE command to force a logoff of any user on the system. The 
format of the FORCE command is: 



1 






• 


1 


FORCE 


I userid 


1 


L 






j 



where; 

userid is the user identification of the user who is to be logged 
off. 



Responses 

The user receives the normal accounting message produced at logoff and a 
logoff message of the following format: 

LOGOFF AT hh:mm:ss zone weekday mm/dd/yy BY SYSTEM 

The primary system operator receives the following message: 

(GRAF raddr) 

\ LINE raddr > LOGOFF AS userid USERS = nnn FORCED 

(DEV rid ) DSCONNECT 

w here : 

raddr is the real line address. 

rid is the real resource identifier. 

userid is the identification of the user who was logged off. 

nnn is the number of users remaining on the system. 

Note: A virtual user may be forced into a disconnected state by the 
system if an unrecoverable I/O error occurs on the virtual console. The 
preceeding message will then be issued with DSCONNECT rather than 
LOGOFF, The user may log on at any time while his disconnected machine 
is still running. See the System Logic and Problem Determination Guide 
for further information. 
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FREE 



Privilege Class: D 



Use the FREE command to remove a set of spool files belonging to a 
specified user from a system hold status. A spool file held by a 
spooling operator can only be freed by a spooling operator; a spool 
file held by a user can be freed by that user or the spooling operator. 
A spool file can be in a double hold status and can only be processed 
after both holds (system and user) are removed. 



The FREE command works in conjunction with the HOLD command. It can 
free only those output files that are in a hold status. The hold status 
of a file is its pending status; that is, it is neither purged nor 
called for spooling output. Ose HOLD to detain a file or a group of 
files temporarily to correct or modify a spooling condition. Blocking 
files from spooled output severely impacts available spooling area. 



A particular file may be held from output because of a device 
restriction, an I/O error on the printer or punch, or a device 
modification. (For example, a printer may not be available, or it may 
have an incorrect print train mounted.) Ihen the condition is 
corrected, the files can then be released for output. The format of the 
FREE command is: 



FRee 



userid 



r i 

IPrinter | 
I PUnch | 
IALI. | 

L J 



where: 
userid 



is the user whose spool files are to be released from a system 
hold status. The user need not be legged on, but his files 
may have previously been held by the HOLD command. 



PRINTER 
PRT 



frees the printer files for the specified user. 



PUNCH 
PCH 



frees the punch files for the specified user. 



ALL 



frees all printer and punch files for the specified user, 



Responses 



None. 
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HALT 

Privilege Class: A 

Use the HALT coaaand to atteapt to terainate any active channel prograa 
on a specified real device. VM/370 atteapts to reset status by issuing 
a Reset Iaaediate coaaand. The foraat of the HALT coaaand is: 



I HALT | raddr | 

t j 



where: 

raddr is the address (cuu) of the real device that the systea 
operator wishes to stop. 

Osage Notes: 

1. This coaaand should be used only in extreme cases and after careful 
consideration. Indiscriminate use of this coaaand aay cause 
unpredictable results. 

2. This coaaand does not affect the 3704 or 3705 Coaaunications 
Controller being run in NCP or PEP aode. See the class A HETWOHK 
coaaand. 

3. For device addresses that have multiple I/O paths defined by the 
VM/370 systea generation process, the HALT raddr command causes a 
HIO to be issued on only that specified path. 

Response 
DEVICE HALTED 

indicates that VM/370 has reset status and halted the device. 
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HOLD 



Privilege Class: D 



Use the HOLD command to place user spool files in a system hold status. 
The spooling operator has the ability to hold the files of any user of 
the system. 

The system hold status for a user is remembered even if the user is 
not currently logged on. Both the user's files and his hold status can 
be reset vith the FREE command. 

Files held by a class D user can only be freed by a class D operator. 
A spool file can be held by a user or by the system spooling operator. 
A spool file held by a spooling operator or a user can only be freed by 
the same spooling operator or user. A spool file can be in a double hold 
status and can be processed only if both holds (system and user) are 
removed. The format of the HOLD command is: 



HOld 



|Printer| 
userid IPUnch j 

L J 



where: 
userid 



is the identification of the user whose spool files are to be 
placed in a system hold status. The user need not be logged 
on when the command is issued. 



PRINTER 
PRT 



holds the printer files for the specified user. 



PUNCH 
PCH 



holds the punch files for the specified user 



ALL 



holds all the printer and punch files for the specified user 



Responses 



None. 
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INDICATE 



Pr ivi lege Class: E 

Ose the INDICATE command to display, at the console, the use of and 
contention for the major system resources of processor and storage. The 
users of this command include the general user and the system analyst. 

The general user can display the use of and contention for the major 
system resources of processor and storage. He can also display the 
number of I/O requests his virtual machine has made and the total amount 
of resources he has used during his terminal session. If he uses the 
INDICATE command before and after the execution of a program, the 
command indicates the execution characteristics of that program in terms 
of resource usage. 

The system analyst can identify the users in gueuel and queue2, the 
I/O devices they are queued up on, the paging devices that may have been 
filled, or the execution characteristics of any user and the total 
amount of resources used by him. 

The system analyst can use the data on system resource use and 
contention to monitor the performance of his system. He can thus be 
aware of heavy load conditions or low performance situations that may 
require the use of more sophisticated data collection, reduction, and 
analysis techniques to resolve these conditions. The format of the 
Class E INDICATE command is: 




I LOAD 

I r i 

| USER |* | 

I juseridj 

I L J 
I Queues 
I I/O 

I r -i 

IPAGing (WAIT | 

I | ALL | 

I L J 




where: 
LOAD 



provides an indication on the operating load of VM/370 by 
displaying values on: the number of users in queue 1 and queue 
2, the usage of real storage, and the ratio of active users to 
users being serviced. 



USER 



[userid] 

allows a system analyst to find out more about the resources 
used and occupied by his virtual machine, and events that have 
taken place. OSERID allows the system analyst to determine the 
activity of virtual machines in terms of the resources used and 
occupied and events that have taken place. Class E users can 
access data from the VMBLOK of any user currently logged on to 
the system in their attempts to understand an overload or poor 
performance situation. The output of this operand is the same 
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as that of the INDICATE USER * option. For detailed discussion 
of the class G INDICATE command, see VM/370 CP Command Reference 
for Gen eral Users. 

QUEUES displays the active users, the queues that they are in, the 
storage that they are occupying, and the status that they are 
in. The display indicates those users currently dominating main 
storage. Users waiting in eligible lists are included in the 
response because they are contending for main storage and it is 
only by chance that they were not occupying main storage at the 
time of the command. 

I/O provides information about conditions leading to possible 
contention within the system. The response gives the userids of 
all the users in I/O wait state at that instant in time, as well 
as the address of the real device to which the most recent 
virtual SIO was mapped. The response, however, does not show 
the queue of users who issue SIOF to busy devices. Because the 
response indicates only an instantaneous sample, use the command 
several times before assuming a condition to be persistent. If 
it is persistent, use the SEEKS operand of the MONITOR command 
to conduct a thorough investigation of the suggested condition. 

PAGING WAIT 

is provided for installations that have 2305s as primary paging 
devices and other direct access devices as secondary paging 
devices. A full primary device and subsequent allocation of 
paging space on the slower device may be responsible for 
degradation of the system's performance. Use the PAGING WAIT 
operand when the QUEUES operand shows that a significant 
proportion of the users in queue 1 and queue 2 are persistently 
in page wait. The response to the command gives the userids of 
those users currently in page wait and the number of page frames 
allocated on drum storage and on disk storage. 

PAGING ALL 

displays the page residency data of all users of the system 
(including the system nucleus and pageable routines) . The 
format of the reply message is identical to that of the PAGING 
WAIT operand. 

Usa ge Notes: 

The intent of the INDICATE command is twofold: 

1. Provide the operator with a "snapshot" of system activities. 

2. Provide a means of determining the execution characteristics of a 
program with respect to the resources it uses. 

In respect to the latter, INDICATE USER should be invoked before and 
after the execution of a program. If the INDICATE USER command is 
issued during the execution of the subject program and the program is 
issuing spooling I/O requests, the results may appear questionable. The 
reason this occurs is that some fields (specifically, the PCH=nnnnnnn, 
PTR=nnnnnn and RDR=nnnnnn fields) in the response to the INDICATE USER 
command are updated once (either at the beginning or at the end of an 
operation). Other fields in the response are updated more dynamically. 
Consequently, you should avoid to halting or aborting any spooling 
operation before its normal termination if the INDICATE USER command is 
to be issued. 
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Responses 

INDICATE LOAD 

CPU-nnn% APD-nnnS Q1-nn Q2-nn STORAGE-nnnX RATIO-nn.n 

CPU-nnnX 

is a smoothed value that indicates the percentage of time that 
the system is running in the main processor. 

APO-nnn56 

is a smoothed value that indicates the percentage of time that 
the attached processor is running. 

Ql-nn Q2-nn 

indicates the contention for CP is represented by smoothed 
values of the numbers of users in queue 1 and queue 2. The 
values are maintained by the scheduler. 

STORAGE-nnnX 

is a measurement of the use of real storage. It is a smoothed 
ratio of the sum of the estimated working sets of the users in 
queue 1 and queue 2 to the number of pageable pages in the 
system, expressed as a percentage. Because the criterion for 
allowing a user on the eligible list to enter a queue is that at 
least 75 percent of his working set size must fit in the 
available page frames, the value of STORAGE can be more than 100 
percent. 

RATIO-nn.n 

indicates the scheduler contention ratio; RATIO is a smoothed 
measure of the contention for real storage, and is defined as 
RATIO= (E*H)/M. H is the number of users in queue 1 and queue 2 
and E is the number of users waiting to be allocated real 
storage by the scheduler and, therefore, temporarily resident in 
the scheduler's eligible lists. Thus, RATIO is the ratio of 
active users to users being serviced, and is 1.0 for optimum 
response. Optimum response occurs when enough storage is 
available to accommodate all active users, assuming the CPU can 
process their commands." lf~E" and~T! are both" 07" the value of 
RATIO is set to 1.0. Values of RATI0=1.5 and H=10, mean that 
users are in the eligible lists waiting for the scheduler to 
allocate real storage space to them and the full discrimination 
ability of the biased scheduler may be exercised upon them. 

r t 

i* i 

INDICATE USER | userid | 

PAGES: RES-nnnn WS-nnnn READS=nnnnnn HRITES=nnnnnn DlSK-nnnn DROB-nnnn 
VTIME=nnn:nn TTIME=nnn:nn SIO=nnnnnn RDR-nnnnnn PRT-nnnnnn PCH-nnnnnn 

The first line of the response gives all the data from the user's YMBLCK 
that is relevant to his virtual machine's pagin n activity and resource 
occupancy. 

n is a decimal number throughout. 

RES is the current number of the user's virtual storage pages 
resident in real storage at the time the command is issued. 

WS is the most recent system estimate of the user's working set 
size. 

82 YM/370 Operator's Guide 



READS is the total number of page reads for this user since he logged 
on or since the last ACNT command was issued for his virtual 
machine. 

WHITES is the total number of page writes for this user since he logged 
on or since the last ACNT command was issued for his virtual 
machine. 

DISK is the current number, taken at an instant of time, of virtual 
pages allocated on system disk paging space for this user. 

DRUM is the current number, taken at an instant of time, of virtual 
pages allocated on system drum paging space for this user. 

The second line of the response gives user CPU usage and accumulated 
I/O activity counts since logon or since the last ACNT was issued for 
his virtual machine. 

VTIME is total virtual time for the user. 

TTIHE is total virtual and simulation time for the user. 

SIO is the total number of nonspooled I/O requests issued by the 
user. 

RDR is the total number of virtual cards read. This value is 
obtained from spool file control information. The total number 
of cards to be read is incremented once to the RDR=value at the 
start of each file read operation. 

PRT is the total number of virtual cards printed. This value is 
obtained from spool file control information. The total number 
of lines to be printed is incremented once to the PRT=value at 
the end of each file print operation. 

PCH is the total number of virtual cards punched. This value is 
obtained from spool file control information. The total number 
of cards to be punched is incremented once to the PCH=value at 
the end of each file punch operation. 

II^ICATE O.UEUES 



userid aa bb sss/ttt userid 



where: 



userid is the user identification. (More than one user may be 
displayed.) 

aa is one of the following: E1, E2, Q1, or Q2, indicating the 
eligible lists or queues that are occupied. 

bb is one of the following status indicators: 

RO current RONUSER in uniprocessor applications. In attached 

processor applications, RO means current RDNDSER on the 

main processor. 
RA current RONOSER on the attached processor. RA does not 

appear in the response line in uniprocessor applications. 
PG in page wait — the user is not executing because CP is 

trying to bring in a page from a paging device. 
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10 in I/O wait — the user is in I/O wait because access to 
the device is not available at the moment. 

EX in instruction simulation wait — the user is waiting for 
the completion of instruction simulation. 

PS in PSW wait — the user is in an enabled wait state for 
high-speed I/O devices. 

DF in attached processor configurations, the processing of a 
synchronous (program or SVC) interrupt for this user has 
been deferred until the system lock is available. DF is 
not applicable for uniprocessor operations. 

Note: In cases where a virtual machine may be in more than one 
of the above states, only one state is displayed; the state 
displayed is the first one encountered in the order of priority 
indicated above. 

sss is a hexadecimal number indicating the number of pages resident 
in real storage. 

ttt is a hexadecimal number indicating the number of pages 
estimated by the dispatcher as the working set of this user. 

Note: The lines of the above response are ordered as follows: 

1. Q1 and Q2 users in runlist priority order (dispatching 
priority) 

2. Eligible list E1 users in scheduling priority order. 

3. Eligible list E2 users in scheduling priority order. 

The significance of these values is important in system 
performance analysis; for details see the VH/37 System 
Progra mmers Guide. 

HO USERS IN QUEUE 

is issued for the QUEUES operand when appropriate. 



INDICATE I/O 

useridl xxx userid2 yyy 

where : 

useridl is a user identification name (s) . 
user id 2 

xxx indicates the real device address. 

yyy indicates that two users are waiting for I/O to complete on the 
device indicated. 

Note: In the case where a virtual machine may have issued 
multiple SIOs, the response indicates the real device address 
corresponding to the most recent one issued. 

NO USERS IN I/O 1AIT 

is issued for the I/O operand, when appropriate. 
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r t 

I ALL | 
INDICATE PAGING |WAIT| 

L J 



useridl xxxryyy userid2 xxx:yyy 

where ; 

useridl is user identification name(s). 
user id 2 

xxx are the number of pages, in hexadecimal, allocated on drum 
storage for these users. 

yyy are the number of pages, in hexadecimal, allocated on disk 
storage for these users. 

Note: One or more users can be indicated. This sample response 
indicates two users. If the two users shown in the response 
were to execute programs of similar characteristics, then 
useridl would be expected to experience more page wait than 
userid2. If users appear to have most of their pages allocated 
on disk storage, it would be useful to know which users are 
occupying most of the primary paging device space, and whether 
or not they are still active. That is, a virtual machine that 
is executing a large operating system may have been allocated 
large amounts of primary paging device space at IPL time but 
then have become inactive. Conseguently, the machine is 
occupying a critical resource but is not using it. If the ALL 
operand is invoked, then xxx and yyy values are given for all 
users on the system. 

NO USERS IN PAGEWAIT 

is issued for the PAGING WAIT operand, when appropriate. 
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LOADBUF 

Privileg e Class: D 

Use the LOADBOF command to load the Universal Character Set (DCS) buffer 
with a specified print chain/train image for the IBM 1403, 3203, or 3211 
Printer or the Forms Control Buffer (FCB) with a specified image for the 
IBM 3203 or 3211 Printer. The device must be drained before the LOADBUF 
command is issued. This command should be used by the class D operator 
to load the UCS buffer of a printer under the following conditions: 

• Any time the print chain/train is to be changed 

• If the buffer has been causing an excessive amount of parity errors 

• When the printer or control unit is powered up since the last buffer 
load 

• If the printer was previously attached to a user 

The FCB buffer should be loaded: 

• Anytime the FCB image is to be changed 

• If the printer was previously attached to a user 

The LOADBUF command automatically sets the Block Data Check latch for 
the UCS buffer load. If VER was specified after the command has been 
executed, the image of the UCS load is printed on the specified printer. 
The printed output must correspond to the description of the specified 
buffer load in the publications IB M 2 821 Control Unit, Order No. 
GA24-3312, or IBM 321 1 Printe r, 3216 Interchangeable Train Cartridge, 
and 3 81 1 Control Unit Description and Operator's Guide , Order No. 
GA 24-3543. The format of the LOADBUF command is: 



i 

| LOADBUF 

I 



fraddr UCS name [Fold] [Ver] ) 
(raddr FCB name [Index [nn ]]J 



where : 

raddr is the address of the printer whose buffer is to be loaded. 



UCi> is a reguired reserved word. 

FCB 



Note: When loading both a print chain image (UCS) and a forms 
control buffer (FCB) , it may be necessary to use two LOADBUF 
commands for the specified printer. 
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name is a one- to four-character name of the UCS or FCB image to be 
loaded. The supplied names are as follows: 

• UCS — 1403 or 3203 

AN normal AN arrangement 

HN normal HN arrangement 

PCAN preferred character set, AN 

PCHN preferred character set, HN 

QN PL/I - 60 graphics 

QNC PL/I - 60 graphics 

EN FORTBAN, COBOL commercial 

IN high speed alphameric 

TN text printing - 120 graphics 

PN PL/I printing - 60 graphics 

SN text printing - 84 graphics 

• UCS— 3211 

A11 Standard Commercial 

H11 Standard Scientific 

G11 ASCII 

P11 PL/I 

T11 Text Printing 

• FCB— 3211 or 3203 

Only one name is provided for an FCB image. For 
information on how to add more FCB images, see the YM/370 
System P rogrammer's Guide . 

FCB1 Space 6 lines/ inch. Length of page 66 lines 

Line Channel Skip 



Represented 


Specification 


1 


1 


3 


2 


5 


3 


7 


4 


7 


5 


11 


6 


13 


7 


15 


8 


19 


10 


21 


11 


23 


12 


64 


9 



FOLD loads the UCS buffer with the folding operation code to permit 
printing of uppercase for lowercase bit configurations. FOLD is 
optional and valid only for UCS. 

Note: The FOLD option causes the control unit to ignore bit 
positions and 1 of the EBCDIC code when comparing the 
character codes from the UCS buffer and the print line buffer. 
Thus, only uppercase characters are printed from either 
uppercase or lowercase data codes. The FOLD option must be used 
with discretion since multiple characters may be printed for the 
same EBCDIC bit configuration depending on the image used. 

VER prints the contents of the buffer on the specified printer for 
verification of the buffer loading function. 

Note : If you are using a 3211 with a P11 train, do not use the VER 
option of the LOADBUF command because a permanent I/O error will result. 
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INDEX [nn] 

starts printing the output in the designated (nn) print 
position, "nn" must be a number from 1 to 31; a leading zero 
need not be specified. If INDEX is not specified, no indexing is 
done. If INDEX is specified without a value, the index value 
specified in the FCB macro becomes the index value. If INDEX is 
specified with a value, the specified value overrides the index 
value in the FCB macro. For a description of the FCB macro and 
forms control images, see the YM/37Q S?s tes Pro<? rag.mer * s Gi2ide ; 
This option is not valid for a 3203 Hodel 4 or 5 printer. 



Response s 



The contents of the 
VEE was specified. 



UCS buffer are printed on the specified printer if 
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LOCATE 

Privileg e C lasses : C or E 

Use the LOCATE command to find the addresses of CP control blocks 
associated with a particular user, a user's virtual device, or a real 
system device. The control blocks and their use are described in the 
VM/370 Data Areas and Contro l Block Logi c. The format of the LOCATE 
command is: 



i 1 

j LOCate j jtiserid [vaddr]) J 

| | \raddr J I 

i i 



where : 

userid is the user identification of the logged-on user. The address 
of this user's virtual machine block (VMBLOK) is printed. 

vaddr causes the virtual channel block (VCHBLOK) , virtual control 
unit block (VCUBLOK) , and virtual device block (VDEVBLOK) 
addresses associated with this virtual device address to be 
printed with the VMBLOK address. 

raddr causes the real channel block (RCHBLOK) , real control unit 
block (BCOBLOK) , and the real device block (RDEVBLOK) 
addresses associated with this real device address to be 
printed. 



Response s 

LOCAT E userid 
VMBLOK = xxxxxx 

LOCATE userid vaddr 

VMBLOK VCHBLOK VCUBLOK VDEVBLOK 
xxxxxx xxxxxx xxxxxx xxxxxx 

LOCATE raddr 

RCHBLOK RCUBLOK RDEVBLOK 
xxxxxx xxxxxx xxxxxx 
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LOCK 

Privilecr e Class: A 

Use the LOCK command to permanently lock in real storage selected pages 
of the pageable CP nucleus or of a user's virtual storage, thus 
excluding them from future paging activity. 

The LOCK command can enhance the efficiency of a particular virtual 
machine by keeping high activity pages such as virtual page zero in real 
storage if the reserved page frames option is already in use by some 
other virtual machine. If the amount of page frames available for 
paging is limited, the LOCK command should not be issued without the 
approval of the systems programmer. 

Note: If too many pages of real storage are locked, the remaining 
virtual machines may not have enough available page frames left to 
operate efficiently. Throughput may then be severely degraded in all 
virtual machines because of excessive contention for the remaining 
available page frames. 

Once a page is locked, it remains locked until either the user logs 
off the system or you issue the UNLOCK command for that page. If a user 
with the "locked pages" option in effect should re-IPL his system or 
load another system, the locked pages are unlocked and available to the 
system being loaded. Note that in the attached processor environment, 
shared pages cannot be locked. Once the virtual=real area is unlocked, 
a lock cannot be issued to run another V=R machine until VM/370 is 
reloaded. 

In uniprocessor mode you can lock a shared page but, if the shared 
page becomes nonshared, the system unlocks it. v In addition, if a 
protected shared page is locked and it is changed, the system unlocks 

it. 

The virtual pages locked in processor storage are blocks of UK (4096) 
bytes. This block of storage need not represent all of the user's 
virtual storage. The LOCK command may be issued as many times as 
reguired for one virtual machine to lock noncontiguous pages of storage. 
The remaining virtual machine storage blocks may remain pageable. The 
format of the LOCK command is: 



i 1 

I LOCK | | userid \ firstpage lastpage [MAP] I 

I 



i userid ) 
\ SYSTEM J 



where : 

userid is the user identification of a logged-on user. 

SYSTEM locks one or more of the pageable CP pages* The pageable 
page(s) are locked until released by the UNLOCK command. 



firstpage 



is the hexadecimal value of the first user page to be brought 
into storage and locked. 



lastpage is the hexadecimal value of the last user page to be brought 
into storage and locked. If only one page is to be brought 
into storage, lastpage must be the same as firstpage. 
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MAP 



prints a map of the virtual storage pages locked and the real 
page that is assigned for each page locked. The response to 
the MAP operand is: 



VIRTPG 



REALPG 
real - first page 



virt-lastpage real-lastpage 



Bote: If you omit the MAP operand from a LOCK command and you later want 
to find the real page, reissue the LOCK command with the MAP operand. 
Ho intervening ONLOCK is required. 

The SYSTEM and MAP operand are useful when you wish to examine (via 
DCP) or modify (via STCP) a page that is normally not resident (such as 
console function routines) . The MAP operand locates the real page for 
display purposes. Page numbers are defined as follows: 



Storage Locations 
(in hexadecimal) 

000-OFFF 
1Q00-1FFF 
2000-2FFF 



Page 
Number 



12000-12FFF 



12 



Examples 

1. For firstpage and lastpage, only the page numbers are specified. 
For example, to lock OSERA* s virtual storage locations X 1 12000* to 
X*2CQ00* in real storage, the following command should be given: 

LOCK OSERA 12 2C 

To lock the first three pages of a OSERA *s storage, enter: 

LOCK OSERA 2 

2. To lock a CP page for display purposes, key in the following lines: 

LOCK SYSTEM 2A 2A MAP 

VIRTPG REALPG) response to the HAP operand 

02A000 04F000J 

DCP 4F038-4F048 

etc. 

ONLOCK SYSTEM 2A 2A 

Re sponse 

COMMAND COMPLETE 
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MESSAGE 



Privilege Class: A or B 



Ose the MESSAGE command to transmit message text to a specified userid 
or to the primary system operator, or as the primary system operator, to 



seiivi s< 



tCk\*Xi t.'CA t. 
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to receive the message is not logged on or has suppressed the receiving 
of messages, the message is not transmitted and the sender receives a 
diagnostic message to this effect. If you send a message to ALL you 
receive a diagnostic message for every user with message typing 
suppressed. A message that is not received by a user is not saved and 
must be sent at a later time when the user is receiving messages. The 
message is displayed at the terminal when the terminal is ready to 
receive output. If a typewriter terminal, or a display terminal having 
AOTOREAD set ON, is entering data, the message is held until a carriage 
return is received. If you want the users to receive messages 
automatically when they log on, see the class B SET command. The format 
of the Class A and B MSG command is: 



I Hessage | (ALL 
I MSG | ) userid 

OPerator 



msgtext 




userid 

OPERATOR 
msgtext 



is for operator use only. It allows him to broadcast a 
message to all logged-on users. 

is a single user who is to receive the message. 

the asterisk (*) specifies that the user is sending the 
message to himself. 



specifies that the message is to be sent to the primary system 
operator regardless of his userid. 

specifies the text of the message that is to be transmitted. 
As many characters may be entered as will fit on the remainder 
of the input line. 



Responses 

hh:mm:ss 

MSG FROM OPERATOR: msgtext 

is the format of the message received by a specified users or all users 
from the system operator. 

hh:mm:ss 

MSG FROM userid: msgtext 

is the format of the message sent to another user or to the system 
operator, where userid is the name of the sender. 
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hh:mm:ss 

HSG FROM LOGONxxx: msgtext 

This is the foriat of a message sent from a user of the VH/370 system to 
a specified user or to a systea operator. This message indicates that 
the user has not yet achieved logon status- xxx denotes the real line 
address from which the MESSAGE command was issued. 

Note: For all of the above responses: 

hh:mm:ss is the time in hours: minutes: seconds when the message was sent 
to the user. 

If the user receiving the message is the primary system operator, 
the alarm bell at the central computer console rings. 

If you are using a 3270, the message puts the screen in a HOLD status 
and rings the Audible Alarm, if present. Press the cancel key to return 
to the RUNNING status. 
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MONITOR 

Privilege Class: A or E 

EVENT TRACING AND RECORDING 

Use the MONITOR command to initiate, override the system generated 
monitor function, or terminate the recording of events that occur in the 
real machine. This recording is always active after a VM/370 IPL 
(manual or automatic) . The events that are recorded in the CP internal 
trace table are: 

External interruptions 

SVC interruptions 

Program interruptions 

Machine check interruptions 

I/O interruptions 

Free storage requests 

Release of free storage 

Entry into scheduler 

Queue drop 

Run user requests 

Start I/O 

Unstack I/O interruptions 

Storing a virtual CSW 

Test I/O 

Halt device 

Onstack IOBLOK or TRQBLOK 

NCP BTO (Network Control Program Basic Transmission Onit) 

Clear Channel operation (CLCH) 



Use the trace table to determine the events that preceded a CP system 
failure. For information on finding and using the internal trace table 
see, the VM/370 System Programmer's Guide 



PERFORMANCE MEASUREMENT 

Use the MONITOR command to: 

• Display the status of the internal trace table, each implemented 
class of data collection, and the specifications for automatic 
monitoring using spool files. 

• Enable various classes of MONITOR CALL. 

J » Specify the time intervals for timer-driven data collection. 

• Start and stop data collection by MONITOR using tape or spool files. 

• Override the specifications for automatic monitoring assigned at 
system generation time. 

• Close the monitor spool files. 

I • Specify device addresses to be included in or excluded from a 
j selection list for DASD seeks analysis. 
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For a discussion of the MONITOR coamand options, see the YH/370 Systea 
Proqraaaer's Guide. The foraat of the Class A and E MONITOR coaaand is: 



MONitor 



Display 



ENable 



r i 
I SPOOL! 
I TAPE | 
I ALL | 

L J 

PEHFora 

RESPonse 

SCHedule 

USER 

INSTsia 

DAStap 

SEEKs 

SYSprof 



INTerval nnnnn 



STArt 



r 

I SPOOL 

I 

I TAPE 



r t 
I SEC | 
I MINI 

L J 



[to userid] [BOFFS n] 

i 
raddr 



I MODE ( 800)| 

I < 1600>| [BDFFS n] 

I (6250JI 

L J 



STOP 



[CLOSE 



AUTOdisk 



TIME 



LIMIT n 



SEEKS 



ICPTRACE 

L 



r i 
I SPOOL | 
I TAPE | 
ICPTRACE! 

L J 



/ON 1 
(OFF) 

5FROM h1:a1 TO h2:a2 
FOR hh:aa 
ALL 
NONE 

r t 

INOSTOPI 
I STOP | 
| SAMPLE | 
s. J 

(INclude raddr raddr. 
) Exclude raddr raddr 
)DELete 
(Display 



^Select one or aore of the classes, subject to the restrictions listed 
with the ENABLE operand. 
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where: 



DISPLAY 



r t 

I SPOOL | 
I TAPE | 
I ALL | 

L J 

displays the status of the pertinent VM/370 Monitor variables 
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default operand. Regardless of the operand you select, each 
class of ionitor call and its current enabled/disabled state 
is listed. 

If SPOOL is specified, the autoaatic Monitoring specifications 
are listed, including whether or not automatic monitoring has 
been requested, its start and stop times, the number of 
monitor buffers to be used, the userid of the virtual machine 
to receive the spool file, the spool file record limit and 
class, and which classes of monitoring are to be enabled. 

If automatic monitoring is already in progress, the spool file 
number is given together with the number of monitor buffer 
records already written to it. 



If the TAPE option is requested, only the status 
classes and CPTRACE table is indicated. 



of monitor 



If ALL is specified, a combination of SPOOL and TAPE responses 
is given. 



ENABLE enables the 
successful co 
control regis 
varies, depe 
inactive when 
active, the n 
8, replacing 
immediately, 
entered. If 
saved, and da 
begin until a 



specified classes of MONITOR CALL. Each 
mpletion of this command creates a new value for 
ter 8. The effect of the MONITOR ENABLE command 
nding on whether data collection is active or 

the command is issued. If data collection is 
ew mask is moved directly into control register 
the previous mask, and the new mask takes effect 

Collection then continues the classes just 
data collection is not active, the new mask is 
ta collection of the specified classes does not 
MONITOR START is issued- 



PERFORM samples system resource usage data by accessing system 
counters of interest to system performance analysts. 

RESPONSE collects data on terminal I/O. Simplifies analysis of command 
usage, user response time, and system response time. It can 
relate user activity to system performance. This class is 
invalid and no data can be collected for it unless the system 
programmer changes the LOCAL COPY file and reassembles DMKMCC. 

SCHEDULE collects data about scheduler queue manipulation. Monitors 
the flow of work through the system- and indicates the 
resource allocation strategies of the scheduler, which is one 
of the key functions of the system. 

DSER periodically scans the chain of VMBLCKs in the system, and 
extracts user resource utilization and status data. 

INSTSIM records every virtual machine privileged instruction handled 
by the control program (CP) . Because simulation of privileged 
instructions is a major source of overhead, this data may lead 
to methods of improving performance. If the VMA feature is 
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active, the number of privileged instructions handled by the 
control program are reduced for those virtual machines that 
are running with the feature activated. 

DASTAP periodically samples device I/O activity counts (SIO) , for 
tape and DASD devices only. 

SEEKS collects data for every I/O request to DASD devices. Reveals 
channel, control unit, or device contention and arm movement 
interference problems. 

Note: No meaningful information is extracted for V=R regions 
if SET NOTRANS is in effect. 

SYSPROF adds to the DASTAP and SCHEDULE classes to support a more 
detailed "profile" of system performance through closer 
examination of DASD utilization. 

Restrictions 

• Every MONITOR ENABLE command yields a new mask. Thus, for example, 
if PERFORM and USER classes are currently being collected and you 
enter MONITOR ENABLE INSTSIM, then PERFORM . and USER classes are 
stopped and INSTSIM is started. 

• The DASTAP operand in the MONITOR ENABLE command must be specified 
prior to the MONITOR START TAPE command. DASTAP may be disabled at 
any time by respecifying the MONITOR ENABLB command with DASTAP 
absent from the class list. 

• The SYSPROF class cannot be activated unless both the DASTAP and 
SCHEDULE classes are also active. 

• If data collection is in progress when you issue a MONITOR ENABLE 
command and CP detects an error in the command line, no change is 
made to the monitoring status. Unrecognizable keywords and 
conflicting operands generate appropriate error messages. If you do 
not specify operands, an error message results. 



r i 
I INTERVAL nnnnn |SEC| mm 
I MINI 

L J 



Use this operand if a 
periodic intervals is 
want to override the 



class that involves collecting data at 
enabled or will be enabled, and if you 
default intervals of 60 seconds and 2 
seconds. The 60 second interval can be considered as the 
primary sampling interval. It determines the frequency with 
which the PERFORM, USER and DASTAP classes of monitor data are 
collected. The two second interval applies to the 
high-frequency data sampling routine. This routine collects 
utilization statistics from the I/O subsystem (channels, 
control units, and devices) when the DASTAP class is enabled. 
The value specified by nnnnn is the interval between data 
collections. If you give no interval on the MONITOR INTERVAL 
command, an error message occurs. Either SEC or MIN may 
follow nnnnn to specify whether nnnnn represents seconds or 
minutes. If you give an interval but enter neither SEC nor 
MIN, the default is SEC. The maximum allowable interval is 
nine hours (540 minutes or 32,400 seconds). The minimum is 
five seconds. If no interval is specified in nnnnn, an error 
message occurs. The mm field is used to change the collection 
interval for the high-frequency sampler. This operand applies 
to the DASTAP class of data collection only. The default 
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value for in is two seconds. If specified, the interval may 
range from 1 to 99 seconds- It Bust be less than the 
specified value of nnnnn. 

If the MONITOR INTERVAL command is not issued, the default 
interval is 60 seconds for the primary sampling interval, and 
2 seconds for the high-frequency sampling interval. The 
MONITOR INTERVAL command can be issued at any time; however, 
if data collection is already in progress, the new interval 
does not take effect until the current interval has elapsed. 
The MONITOR interval is reset to the defaults when: 

• You issue MONITOR STOP, or the monitor stops automatically. 

• The system stops the monitor because of an unrecoverable 
I/O error. 

• The end-of-tape is reached, or the spool record limit is 
reached. 



r i 

START |SP00L* [to userid] [BUFFS n] | 

ICPTRACE r -, \ 

I TAPE raddr |MODE f 800) | [BOFFS n]| 

I I < 1600>| | 

I I (6250) | | 

L L J J 

If SPOOL is specified, VM/370 Monitor data collection is begun 
to the spool file or tape, or the CP internal trace table is 
started. If no optional parameter is provided, SPOOL is the 
default. 

When data collection is stopped and the spool is closed, the 
spool file is added to the chain of reader files destined for 
the virtual reader of the virtual machine defined by "to 
userid." The userid may be specified as an asterisk (*) if 
the recipient virtual machine is to be the one from which the 
START command is issued. If the "to userid" option is 
omitted, the userid specified in the SYSMON macro instruction 
is used. (See IBM virtual Machine FacilitY/37Q Plan ning and 
System Generation Guide.) The "to userid" option overrides 
the SYSMON specification and stays in effect until the system 
is re-IPLed or a new command that uses the "to userid" option 
is entered. 

The monitor spool file is closed by a MONITOR STOP or MONITOR 
CLOSE command, or when the record count limit is reached (as 
specified in the SYSMON macro) , or when a system restart or 
system shutdown occurs. 

The filename and filetype of the monitor spool file are 
generated internally with the filetype, identifying date and 
time of starting. The class of spool file is specified in the 
SYSMON macro and defaults to "M." If no classes of data 
collection have been specified with an ENABLE command, those 
specified with the SYSMON macro are used. 

The number of monitor buffers used are as specified in the 
SYSMON macro, or as requested with the BOFFS option of the 
START command. The BOFFS option overrides the SYSMCN 



*The default value is the active trace facility that is SPOOL or TAPE, 
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specification for the duration of the data collection session. 
Future monitoring sessions will also return to the SYSMCN 
specification unless again overridden. If the number of 
buffers specified in the SYSMON macro has been defaulted, then 
the defaults, as described in the MONITOR START TAPE command, 
are adopted. 



If CPTRACE is specified, the tracing cf events that occur on 
the real machine is begun. The events are recorded on the CP 
internal trace table in chronological order. When the end of 
the table is reached, recording continues at the beginning cf 
the table, overlaying data previously recorded. 



If TAPE is specified, data collection by MONITOR onto a tape 
mounted on a 9-track tape drive is begun. Specify the real 
hexadecimal address of the tape drive that you want to use in 
raddr. This activates data collection for those classes of 
MONITOR CALL previously specified in a MONITOR ENABLE command 
and begins data collection. The mask that was saved by the 
MONITOR ENABLE command is moved into control register 8. The 
data is collected into buffer pages in real storage. These 
pages are separate from the internal trace table pages. The 
BUFFS n operand, where n is a value from 1 to 10, specifies 
the number of U096-byte buffers to be used for monitoring 
operations. If the operand is omitted, a default value is 
supplied depending upon the processor model number. 

Model 

135 

138 

145 

148 

155 

158 

165 

168 

3031 

3032 

3033 

The operator may specify BUFFS 1 if the command entry is 
limited to ENABLE PERFORM for data collection. Once 
monitoring is in progress with one buffer specified, it is not 
possible to invoke MONITOR with additional ENABLE operands 
because of the buffer limitation. 

Note; Single buffer operation is useful for basic performance 
analysis in minimum main storage configurations. 

As each data page is filled, it is written on the tape. CP 
issues a rewind command followed by a SET MODE command for the 
reset value of tape density when MONITOR is started. You can 
request a different mode setting by specifying the MODE option 
in the MONITOR START TAPE command. Mode values of 800, 1600, 
or 6250 may be specified. If you specify a density mode that 
the tape drive cannot handle, the control unit does not return 
an error condition. In this case, the mode setting is ignored 
and the default control unit setting is used. 
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r t 

STOP | SPOOL | 

ICPTRACEI 

| TAPE | 

L J 



If SPOOL is specified, the VM/370 Monitor data collection to a 
spool file or tape is stopped or the CP internal trace table 
is stopped. If no option is specified and the VM/370 Monitor 
is active, then data collection will be terminated whether a 
spool file or tape is in use. Internal tracing can only be 
stopped by specific use of the CPTRACE option. If automatic 
VM/370 Monitor data collection is active when the MOHITOR STOP 
SPOOL command is entered, monitoring ceases and will not start 
again (even if the current time is within the bounds of the 
TIME operand of the SYSMOH macro) unless the system fails or 
is shut down and reloaded. 



If CPTRACE is specified it terminates the internal trace table 
event tracing. Event recording ceases but the pages of 
storage containing the CP internal trace table are net 
released. Tracing can be restarted at any time by issuing the 
MOHITOR START CPTRACE command. 



If TAPE is specified it stops data collection by MOHITOR on 
the tape. A zero mask is immediately stored in control 
register 8, thus disabling MOHITOR CALL interruptions. The 
last partially filled page is written out, two tape marks are 
written, and the tape is rewound and unloaded. The two buffer 
pages, which were obtained at the time the MCNITOR START TAPE 
command was processed, are released. 

Hote: The CPTRACE and TAPE or SPOOL operands of the MOHITOR 
command are completely separate functions. Commands affecting 
the status of one function have no effect on the other. 



CLOSE 

closes the current spool file, making it available to the 
reader of the recipient virtual machine and continues 
monitoring with a new spool file. This option may be used 
when the VM/370 Monitor is spooling the collected performance 
data and you want to reduce the data collected thus far. 

AOTODISK /OH ) 
\OFF / 
overrides the specification in the SYSMOH macro for automatic 
monitoring. This only affects the automatic startup of 
monitoring* If automatic monitoring is already active, only a 
MOHITOR STOP command will stop it manually. 

Hote: In general, any attempts to override the definitions of 
the SYSMOH macro instruction with commands are temporary. Ho 
Monitor checkpointing is attempted so that an IPL or crash 
causes full restoration of the initial automatic monitoring 
definitions. 
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TIME /FROM h1:m1 TO h2:m2 

) FOR hh:mm 

\ ALL 
NONE 

temporarily overrides the automatic monitoring start and stop 
times defined by the SYSMON macro instruction. FROM h1:m1 TO 
h2:n2 specifies a start and stop time in hours and minutes 
using a 24- hour clock. (The default start time is 09:00 and 
end time is 17:00). FOR specifies the length of time data 
should be collected; it is intended to facilitate performance 
data collection over short periods of time for testing or 
benchmarking. Automatic monitoring must be in effect before 
this parameter is specified (AUTO=YES in the SYSMON macro of 
DMKSYS or MONITOR ADTO ON command) . ALL specifies 24-hour 
monitoring and NONE specifies that monitoring can only take 
place under the direction of operator or system analyst. 

Note: If automatic monitoring is imminent and the FOR option 
is specified, the period of monitoring defined by the SYSMGH 
macro is overridden. 



r t 

LIMIT n |NOSTOP| 
| STOP ! 
j SAMPLE j 

L J 

temporarily overrides the LIMIT options of the SYSMON macro, 
n is a decimal number from 10 to 50000 that represents the 
maximum buffer count in each spool file. If it is necessary 
to change the automatic monitoring specification after the 
limit is reached and the spool file is closed, the STOP or 
NOSTOP option may be specified. If you wish to change the 
automatic monitoring specification without changing the limit 
number, specify an asterisk (*) instead of a decimal number 
for n. 

If SAMPLE is specified, n indicates the number of samples of 
PERFORM, USER, or DASTAP data (or any combination of the 
three) that are to be collected before the spool file is 
closed. After n samples of data have been collected, the 
monitor spool file is closed and moved to the virtual reader 
of the data reduction virtual machine. Monitoring continues 
uninterrupted using a new spool file. Automatic monitoring is 
specified by using the SYSMON macro instruction in DMKSYS at 
system generation. 

SEEKS (INCLUDE raddr raddr... 
) EXCLUDE raddr raddr... 
\ DELETE 

(display 

This command option is used to control selective seeks 
monitoring* This enables the user to obtain seeks trace data 
on only those non-2305 DASD devices that are specifically 
requested. The command allows a list of devices to be 
established for data collection and permits display or 
deletion of an existing list. This decreases both the 
overhead involved in collecting the data and the processor 
time to reduce the data. 

The INCLUDE option followed by a list of non 2305 DASD device 
addresses, specifies the devices for which seeks data is 
collected. The appropriate MONITOR ENABLE and START commands 
must be issued to invoke this function. 
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The EXCLUDE option specifies the devices for which seeks data 
should not be collected. 

The DISPLAY option enables the contents of the list to be 
reviewed. 

The DELETE option cancels the list, thus freeing the occupied 
real storage. 

Note: A device list established with the INCLUDE or EXCLUDE 
option is retained across separate monitoring sessions. A 
list is not cleared when a MONITOR STOP commmand is entered; 
however, the DISPLAY and DELETE options are provided for list 
revision when SEEKS analysis is completed. 

Though as many device addresses as can fit on a single input 
line may be entered, for performance reasons the list should 
be kept as short as possible. 

Usage Notes: 

The MONITOR command's response to unusual conditions are detailed in the 
following paragraphs. 



BufijJS. Automatic Monitoring Using Sjjool Files 

SHUTDOWN: Data collection is terminated with a MONITOR STOP SPOCL 
command. The spool file is closed and moved for data reduction to the 
reader chain of the designated virtual machine. 

SYSTEM FAILURE: The current monitor data collection buffer is abandoned 
but the spool file containing all previously output buffers is closed 
and made available to the virtual reader of the designated virtual 
machine for further data reduction. 

INITIAL PROGRAM LOAD: If automatic monitoring has been specified with 
the SYSMON macro of DMKSYS and the IPL occurs within the time range 
specified on that same macro, monitor data collection is automatically 
started. The operator is informed but no action is required. He may, 
however, use the MONITOR DISPLAY SPOOL command to check the 
specifications for automatic monitoring. 

SPOOL SP ACE : If automatic monitor data collection is regularly active 
and system messages are issued indicating serious loss of spool space, 
several checks should be made by the operator: 

• Ensure that adequate arrangements have been made to read and reduce 
the monitor spool files on a day-to-day basis so that the occupied 
spool space can be returned to the system. 

• Ensure that the data collection classes do not include trace classes, 
which produce large volumes of data (e.g. INTSIM or SEEKs) . Do this 
with the MONITOR DISPLAY command remembering that the specifications 
of the DMKSYS macro SYSMON may be temporarily overridden by the 
operator or systems analyst using the MONITOR command. 

• If spool space is a scarce or critical resource, monitoring can 
either be done to tape or the LIMIT parameter used. The LIMIT 
parameter of the SYSMON macro or the LIMIT option of the MONITOR 
START SPOOL command can be used to restrict the maximum size of the 
monitor spool file by terminating monitoring when the maximum record 
count is reached. 
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SUSPENSION: The system analyst may determine, after studying the data 
reduction reports, that data collection suspension is occurring because 
of insufficient buffer space. The operator lay be requested to increase 
the buffer allocations using the BUFFS n option of the MONITOR STABT 
coiaand until the SYSMON aacro in DHKSYS can be revised. 



During Manual Monitoring Using Tape 

SUSPENSION: Data reduction aay determine that data collection suspension 
is occurring because of insufficient buffer space. This usually occurs 
when classes USES and/or DASTAP are enabled, while large numbers of 
users are logged on, or the system I/O configuration is extensive. Loss 
of data aay be avoided by specifying additional buffers (with the BDFFS 
option of the MONITOR START TAPE coamand) until no aore suspensions are 
reported by data reduction. 

UNRECOVERABLE TAPE ERROR; Unrecoverable tape errors are errors that the 
I/O error handling routines cannot recover froa by standard recovery 
procedures. When an unrecoverable error occurs, MONITOR tries to write 
two tape marks and rewind/unload the tape. The use of the tape is 
abandoned and data collection stops. The operator is inforaed or action 
taken. Whether or not the write-tape-marks and rewind/unload is 
successful, the tape drive is released. 

END-OF- TAPE CONDITION: When end-of-tape occurs, a tape mark is written 
on the tape and it is rewound and unloaded. MONITOR is stopped and the 
operator is informed of the action taken. 

INITIAL PROGRAM LOAD: MONITOR START CPTRACE is active after real system 
IPL (manual - or automatic) . The MONITOR tape data collection is off 
after IPL. 

SHUTDOWN: Systea shutdown iaplies a MONITOR STOP TAPE coamand. The 
system performs normal command processing for the STOP TAPE function. 

SYSTEM FAILURE: If the VM/370 system fails and data collection is 
active, an attempt is made to write two tape marks and rewind/unload the 
tape. If the tape drive fails to rewind and unload, be sure to write a 
tape mark before rewinding and unloading the tape. MONITOR data 
collection is terminated by the system failure. 

I/O DEVICES: A supported tape drive must be dedicated to the system for 
the duration of the monitoring. 



Responses 

The following response occurs if you issue the MONITOR DISPLAY command 
and data collection is on tape. If spool files are used, then the 
automatic monitoring specifications and status are listed as described 
in the MONITOR DISPLAY section. 

CLS KEYWORD STATUS 
nn keyword ENABLED 
nn keyword DISABLED 



CPTRACE ENABLED 
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The following response occurs for MONITOB commands, other than MONITOR 
DISPLAY, that successfully execute: 

COMMAND COMPLETE 
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MSGNOH 

Privilege Class : B 

Use of the MSGNOH command provides the ability for a system service 
virtual machine to send messages to specified users without the standard 
header associated vith the MESSAGE command. The format of the class 8 
MSGNOH command is: 



I MSGNOH | {userid} msgtext | 

i I 



where ; 

userid is the identification of the virtual machine to receive the 
message. 

msgtext specifies the text of the message that is to be transmitted. 
Length of the message may be as long as the remainder of the 
input line. 



Response s 

msgtext only the message text is received by the specified virtual 
machine. 
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NETWORK 

Privileg e Class; A or B 

The CP NETWORK command loads, dumps, and controls the operation of a 
370x control program in the VM/370 environment. NETWORK is also used to 
control remote 3270 devices attached to VH/370 via binary synchronous 
lines and 270X or 370x (operating in 270X emulation mode (EP) ) control 
units. 

NETWORK COMMAND O'SAGE FOR 370X FUNCTIONS 

The NETWORK command: 

Causes 370x dump operations 

Initiates 370x load operations 

Enables or disables terminal resources 

Varies resources online or offline 

Halts a particular resource 

Ceases all 370x operations 

Queries and displays 370x resource status and storage 

Traces line activity to and from a 370x resource 

NETWORK COMMAND USAGE FOR REMOTE 3270 

Use the NETWORK command to control remote 3270 resources and to vary the 
polling delay on the binary synchronous lines that are connected to 
these resources. The NETWORK command may be used whether the remote 
3270 resources are connected to a 2701, 2703, or to a 370x in Emulation 
Program (EP) mode with lines in EP mode. 

The operands that specifically affect remote 3 270s are: 

• SHUTDOWN (Class A) • VARY (Class A, B) 

• POLLDLAY (Class A,B) • DISABLE (Class A,Bj 

• ENABLE (Class A,B) • QUERY (Class A,B) 

RESOURCE IDENTIFICATION FOR REMOTE 3270' S DEVICE AND CONTROL UNITS 

Resources are defined as display stations, printers, and control units 
in the 3270 remote system. Whenever a remote 3270 resource is referred 
to in the NETWORK command, and is identified in a VM/370 system message, 
the format is a four- character hexadecimal number, where the three 
low-order characters are the actual station resource identifier, and the 
high-order hexadecimal character is a relative line code associated with 
a particular physical Binary Synchronous Communication (BSC) line that 
remote 3270 terminals use. When the 3270 resource is referred to in the 
SET PFnn COPY command, the 3-character hexadecimal number is the remote 
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resource ID. The 3270 remote resource ID is a 12-bit binary value that 
can have a low value of zero, to a high value determined by the number 
of CLUSTER and TERMINAL macro instructions defined for a communication 
line (RDEVICE) during system generation. For example, assume that there 
are two BSC lines for remote 3270 display systems in a particular 
conf iguration* The first line to appear in the DMKRIO module would be 
assigned a code of 0, the second line would have a code of 1. Any other 
binary synchronous lines used for other purposes are ignored. Resource 
ID 12 (decimal) on communication line 1 would be represented as "000C"; 
resource ID 31 on communication line 2 would be represented as '101F*, 
etc. 



HOW TO USE THE NETWORK COMMAND 

| When using the NETWORK command to control the operation of the 370x 
Emulation Program or remote 3270s on a 2701, 2703, or 370x in Emulator 
Program (EP) mode with lines in EP mode, the operator must be aware of 
the different classes of resources that are defined at generation time 
for the 370x control program and the 3270 remote support. 

When operating with a 270x or an Emulation Program, there is only one 
| address for each logon device, and that is the physical subchannel 
address for the telecommunications line. For a simple leased line 
configuration, there is one resource ID for each line, and one resource 
ID for each terminal (one terminal per line) , alternating in numeric 
value. 

The majority of the NETWORK command operations are performed for 
terminal resources. For example, NETWORK ENABLE, DISABLE, QUERY, HALT, 
VARY ONLINE, and VARY OFFLINE all operate for terminals. The NETWORK 
QUERY command line can be used to display the status of a line resource, 
but only when the "NETWORK QUERY resource" command format is used. The 
possible states of a line resource are: 

• OFFLINE (that is, inactive) 

• ACTIVE 

| • EP-MODE 

While the NETWORK VARY ONLINE and VARY OFFLINE command lines may be used 
for a line resource, they are primarily intended for use with terminal 
resources, because the state of the line changes automatically if the 
| terminal is enabled or disabled. Also, NETWORK VARY EP is valid only 
for line resources and, in this case, the terminal resources change 
state when the line changes state. 

The only way to tell which resources are lines and which are 
terminals is to examine the output from the first stage of the 370x 
control program generation. The installation system programmer (or 
whoever performs the 370x control program generation) , should prepare a 
cross-reference list of resource IDs and their characteristics (such as 
line or terminal, type of line, location, and so on) for the operations 
personnel. Use the following commands: 
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For terminal only 

NETWORK ENABLE 
NETWORK DISABLE 
NETWORK QUERY ACTIVE 
NETWORK QUERY FREE 
NETWORK QUERY OFFLINE 
NETWORK QUERY ALL 

For lines only 

NETWORK VARY EP 
NETWORK TRACE resource 

For either lines or terminals 

NETWORK QUERY resource 
NETWORK HALT 
NETWORK VARY ONLINE 
NETWORK VARY OFFLINE 

The format of the class A NETWORK command is: 



i 1 

| NETWORK | HALT resource I 

III I 

i i 

where ; 

HALT resource 

attempts to terminate any active channel program on the 
specified resource (line or terminal) . The term resource is a 
4-digit hexadecimal identity of a 370x resource. The last 
three digits are the actual NCP resource ID- The first digit 
is a device seguence number associated with a particular 370x. 
This device seguence number designates the relative position 
of the device in the DHKRIO module: the first 370x listed has 
a device seguence number 0, the second listed has a device 
seguence number 1, and so on. 



Response s 

NETWORK HALT 

The normal response is: 

DEVICE HALTED 

This response indicates that VM/370 has attempted to reset status and 
halt the device. 
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The format of the class A and B NETWORK command is: 



NETWORK 



LOAD raddr ncpname 

r i 

DUMP raddr IIMMEDI 

I OFF | 

I AUTO | 

L J 

r t 

EN able | ALL | 

(resource [resource. .. ]| 



DISAble | ALL | 

| resource [resource.-.]! 

L J 

r t 

Query 1 ACTive | 

fOFFline | 

|FREe | 

|ALL | 

| resource [resource. .. ]| 

L J 



Display raddr hexlod j (-) |hexloc2| 

It:/ 



I END 

u 



VARY /ONline 
(OFFl 



ne ) 
inej 



I r i 

I {•} Ibytecountl 
I IEND | 

L L J J 

resource [resource...] 



r t 

POLLdlay nnnn I ALL | 
Iraddr | 



where ; 

LOAD raddr ncpname 

loads an EP 370x control program. 

raddr is the real address of the 370x to be loaded. 

ncpname is the name, previously defined by a NAMENCP macro and 
saved on a CP volume, of the 370x control program image 
to be loaded into the 370x specified by raddr. 

r i 

DUMP raddr jIMHEDj 

(OFF I 

IAUT0 | 

L J 

dumps the contents of 370x storage for EP 370x control programs, 
raddr is the real address of the 370x to be dumped. 
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IMHED specifies that the 370x is to be dumped immediately. 
See the "NETWORK Dump Operations" section for 
additional information. 

OFF specifies that the 370x is not to be dumped 
automatically if the 370x control program abnormally 
terminates. 

AUTO specifies the automatic dumping and reloading of the 
370x if the 370x control program abnormally terminates. 

r t 

ENABLE | ALL | 

j resource [resource...]} 

L J 

activates 370x resources (terminals only) and remote 3270 
resources for use by VM/370. The resource operand may be 
enabled selectively by specifying the four-digit hexadecimal 
identity of the terminal resource to be enabled. The last 
three digits are the actual resource identification. The 
first digit is a device seguence number associated with a 
particular 370x. This device seguence number designates the 
relative position of the device in the DMKRIO module: the 
first 370x listed has a device seguence number 0, the second 
listed has a device seguence number 1, and so on. The 
resource specified must be a terminal device. The NETWORK 
ENABLE command first ensures that the associated line resource 
is activated, and then enables the terminal device or, in the 
case of remote 3270s, formats the screen. The response from 
enabling terminal devices or formatting the screen is the 
appearance of the "vm/370 online" message on the terminal. 

Note: If the device being selectively enabled is a 3275 remote 
display unit and the unit is eguipped with a printer to handle 
the display's hardcopy output (via PFnn COPY), then the 
printer must also be enabled. 

r t 

DISABLE | ALL | 

| resource [ resource. .. ]| 

L J 

disables 370x resources (terminals only) and remote 3270 
resources. ALL disables all 370x terminals. The resource 
operand used to disable selective resources, specify the 
four-digit hexadecimal identity of the terminal resources to 
be disabled. The last three digits are the actual resource 
ID. The first digit is a device seguence number associated 
with a particular 370x. This device sequence number 
designates the relative position of the device in the DMKRIO 
module: the first 370x listed has a device seguence number 0„ 
the second listed has a device sequence number 1, and so on- 

If any of the resources specified on the NETWORK DISABLE 
command are in use at the time the command is issued, they are 
not immediately disabled. However, as soon as the resource 
becomes free (usually after a LOGOFF command is issued) , the 
resource is automatically disabled. 
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r i 

QUERY | ACTIVE | 

| OFFLINE | 

IFREE | 

I ALL | 

| resource [resource. .. ]| 

L J 

displays the status of 370x resources (lines or terminals) and 
remote 3270 resources. 

ACTIVE displays only the resources (terminals, remote 3270 display 
and printer stations) that are active (those being used by 
VM/370 users) . 

OFFLINE displays only resources (terminals, remote 3270 display and 
printer stations) that are not available to VM/370 users* 

FREE displays only resources (terminals, remote 3270 display and 
printer stations) that are not offline and also not currently 
in use. 



ALL 



displays the active, 
(terminals or remote 
attached to all 3704 
VM/370 system. 



offline or free status of each resource 

3270 display and printer stations only) 

and 3270 remote control units on the 



With the exception of remote 3270, "resource" displays only 
the resources (lines or terminals) whose four-digit 
hexadecimal identity is specified. The last three digits are 
the actual resource ID. The first digit is a device sequence 
number associated with a particular 370x. This device 
sequence number designates the relative position of the device 
in the DMKRIO module: the first 3704 or 3705 listed has device 
sequence number 0, the second listed has device sequence 
number 1, and so on. 



DISPLAY raddr hexlod 



r r t 

-\ |hexloc2| 

END | 



{:} 



r i 

{.} Ibytecount | 

(END I 

L L J J 

this operand reserved for 370x operations only, displays the 
contents of 370x storage. The data is displayed in fullwords. 
No EBCDIC translation is provided. 



The raddr operand is the real 
storage is to be displayed. 



address of the 370x whose 



bytecount 



The hexlod operand specifies the hexadecimal address of the 
start of the display and must be specified. To display more 
than one fullword, : or - or . must be specified. 

The hexloc2 operand specifies the hexadecimal location of the 
end of the display. 

specifies the number of bytes to be displayed. The sum of 
hexlod and bytecount must be an address that does not exceed 
the 370x storage size. Bytecount must have a value of at 
least one. A minimum of four bytes is displayed. 
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END 

indicates that the display continues until the end of storage 
is reached and is the default if hexloc2 or bytecount is not 
specified. 



VARY ([ONLINE \ resource [resource...] 

(OFFLINE) 

I 

I varies the status of specified 370x resources. 

ONLINE places a resource (line or terminal) online. 

OFFLINE places a resource (line or terminal) offline. 



Note ; only the ONLINE and OFFLINE operands are valid for 
remote 3270 resources. 

With the exception of remote 3270, resource is a four-digit 
hexadecimal identity. The last three digits are the actual 
resource ID. The first digit is a device sequence number 
associated with a particular 370x- This device sequence 
number designates the relative position of the device in the 
DHKRIO module: the first 370x listed has a device sequence 
number 0, the second listed has a device sequence number 1, 
and so on. 



r t 

POLLDLAY nnnnlALL | 
j radar j 

L J 

changes the duration of the polling delay interval for the 
binary synchronous line to the value of nnnn. The address of 
the binary synchronous line is raddr and nnnn is the decimal 
number in tenths of a second (not to exceed 9999) for the 
polling delay interval. If ALL is specified, the polling 
delay interval is set for all the 3270 remote lines. 

The polling delay interval that is defined at system 
generation is two seconds. 

Note: The polling delay interval is that period of time from 
the time a binary synchronous line receives a negative 
response from a general polling sequence until the polling 
delay interval expires, or a message is sent to the station on 
the binary synchronous line. 

The polling delay interval minimizes unproductive polling and 
processor meter time. In general, if no data or other 
communications is being received from the stations on the 
binary synchronous line, the polling delay interval is started 
and control is given to the dispatcher. 
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Responses 



NETWOR K LOAD 

CTLR raddr ncpname LOAD COMPLETE 

The 370x "raddr" was successfully loaded with the control program 
"nopname" * 

NETWORK DUMP 

CTLR raddr DUMP COMPLETE 

The 370x "raddr" was successfully dumped. 
NETWORK ENABLE, NETWOR K DISABLE , NETWORK VARY 
The normal response is: 

COMMAND COMPLETE 
NETWORK HALT 
The normal response is: 

DEVICE HALTED 

NE TWORK QUERY 

DEV rid LOGON AS userid 
DEV rid DISABLE 
DEV rid ENABLED 
DEV rid OFFLINE 

LINE rid ACTIVE 
LINE rid OFFLINE 

DEV ridl ENABLED, DEV rid2 ENABLED, DEV rid3 ENABLED,... 
DEV ridl DISABLE, DEV rid2 DISABLE, DEV rid3 DISABLE,... 
DEV ridl OFFLINE, DEV rid2 OFFLINE, DEV rid3 OFFLINE, 

Note: If either of the following responses occurs, a problem exists with 
the Network Control Program and/or the 370x. 

(ACTIVE ) 

<FREE > rid NOT FOUND 

(OFFLINE) 

rid NOT FOUND 

where : 

LOGON indicates that the resource is in use as a virtual machine 
operator console, by "userid"* 

DISABLE indicates that the resource is online but is not available for 
access to VM/370. 

ENABLED indicates that the resource is available for user access to 
VM/370. 

ACTIVE indicates that the line resource is online and has been 
activated. Terminals on the line may or may not be in use. 
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FREE indicates that the resource is not offline and also not 
currently in use. 

EP-MODE indicates that the line resource is a PEP line currently in 
emulation mode at real address "raddr". 

OFFLINE indicates that the resource is inactive and unavailable for 
use. 

rid is the real resource identifier. 

userid is the user identifier. 

raddr is the real device address. 
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ORDER 



Privilege class; B 



Use the ORDER command to place closed spool files (of a specified device 
type) in a different order. You aay determine via the QUERY coaaand the 
filename, filetype, originating userid, and other attributes of all of 
your files. The format of the ORDER command is: 



ORDer | r n (Reader 

j | user id J ^Printer 

I | SYSTEM | JPOnch 

I l J 



("Class d CLass c2... 
| spoolid 1 spoolid2 



}I 



^Sequencing may be done with the ORDER command using a combination of 
"CLASS c" specifications and spoolid specifications. For example 

ORDER PRINTER CLASS A 1963 CLASS C 

specifies that printer files will be processed in the following 
order: all Class A files, the file with the spcolid 1963, all Class 
C files. 



wh ere : 
userid 

SYSTEM 



READER 
RDR 



allows the spooling operator to manipulate the spool files for 
a particular user. 

allows the spooling operator to manipulate all spool files in 
the system, regardless of userid. 

orders the reader files. 



PRIHTER 
PRT 



orders the printer files. 



PONCH 
PCH 



orders the punch files. 



CLASS c orders the files by their class, "c" specifies class 
designations for input and output spool files. This 
specification allows files to be placed in the order of 
classes specified by CLASS d, CLASS c2, and so forth, c is a 
one-character alphameric field with values that extend from A 
to z and froa to 9. 

spoolid processes the files in the order in which the spoolids are 
given. 



Responses 



fnnnn) FILES ORDERED 
\N0 / 



is the response to the user who issued the ORDER coaaand 
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PURGE 



Privilege Class: D 



Ose the PURGE command to remove closed spool files froi the system 
before they are printed or punched by the spooling devices, or before 
they are read by a user. The spooling operator can purge any file in the 
system. Any file can be purged, regardless of its status, as long as it 
has not been selected for processing. The format of the PURGE command 
is: 



PURge 



1 r t 


j Reader 


r 


I | user id | 


\ Printer 


1 hlik 


| | SYSTEM | 


< PUnch 


I Class d Class c2 


1 L J 


j 


I spoolidl spoolid2 




(all 


L 



^Purging may be done using a combination of CLASS c and spoolid 
specifications. For example: 

PURGE PRIHTER CLASS A 1932 CLASS D 619 

specifies that all class A and class D files and files with spoolid 
1932 and 619 are to be purged. 



w here : 
userid 



is the user identification for the user whose spool files are 
to be purged. 



SYSTEM allows the spooling operator to purge all files on the system, 
regardless of userid. 

READER purges the reader file. Optionally, the reader files may be 
purged by class or spoolid. 

PRIHTER purges the printer files. Optionally, the printer files may 
be purged by class or spoolid. 

PUNCH purges the punch files. Optionally, the punch files may be 
purged by class or spoolid. 



ALL 



purges all the files; all operands that follow it, if 
specified, are ignored. If ALL follows READER, PRINTER, or 
PUNCH, only the files for that device type are purged. 



CLASS c purges the files of the specified class, for the specified 
device type. 

spoolid purges the files of the specified spool identification, for 
the specified device type. 
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Re spo nses 

fnnnn) FILES PURGED 
(HO I 

indicates the number of files purged. 

Note: This response is suppressed if the virtual machine user has issued 
the SET IHSG OFF command. 

The system operator, monitoring the RSCS virtual machine for his 
installation, should not specify this option because information 
messages are required for accurate monitoring of RSCS system activity. 
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QUERY 



Pr ivil ege Classes: A, B, C, D, E, or F 



Use the QUERY coinand to request system status and machine configuration 
information. (For 3704 or 3705 Communication Controllers and reiote 
3270 resources see the Class A and B NETWORK command.) Hot all operands 
are available in every privilege class. 



Operands available to the specified privilege classes 
The format of the Class A and E QUERY command is: 



are given below. 




AFFinity [userid] 

CPAssist* 

Journal 2 

PAGing 

PRIORity userid 

SASsist* 



*The collective use of both QOERY CPASSIST and QUERY SASSIST is used 
to determine the current status of the expanded virtual machine 
assist portion of the VM/370 Extended Control-Program Support 
(VM/370: ECPS) . 

2 The JOURNAL operand is valid only if STQUERY=YES is specified in 
the SYSJRL macro instruction in DHKSYS. 



where: 



AFFINITY [userid] 

(attached processor applications only) displays the affinity 
setting of a specific virtual machine or all virtual machines 
that are logged onto the system. The affinity setting is 
accomplished in the VM/370 directory OPTION statement or via 
the CP SET command. The affinity setting of a virtual machine 
indicates the selected processor (main or attached) that is 
used to execute the programs of a virtual machine. If there 
is no affinity setting for a virtual machine, then the virtual 
machine is dispatched for execution on the first available 
processor. 



CPASSIST 



displays the current status of the CP assist for the VM/370 



JOURNAL displays the status of the logon/link journaling facility. 

PAGING displays the current system paging activity. 

PRIORITY userid 

displays the current priority of the specified userid. This 
is established in the VM/370 directory but can be overridden 
by the SET PRIORITY nn command. 

SASSIST displays the current status of the virtual machine assist for 
the VM/370 system. QUERY SASSIST also indicates the current 
status of virtual interval timer assist portion of VM/370: 
ECPS. 
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Responses to the Class A and E Query Commands 

QUERY CPASSIST 

CPASSIST /ON ) 
| OFF J 

where ; 

OH indicates that the CP Assist portion of the VH/370 Extended 
Control-Program Support is active. 

OFF indicates that the CP Assist portion of the VH/370 Extended 
Control-Program Support is inactive or not available on the 
System/370 Processor. 

Note: To determine the active status of the Expanded Virtual Machine 
Assist portion of ECPS requires a positive response to QUERY CPASSIST 
and QUERY SASSIST. 

| QUERY JOURNAL 

j J ON \ (OH \ 

I JOURNAL LOGON (OFF J LINK \OFFJ 

I where : 

I ON indicates the relevant journaling function is active. 

! OFF indicates the relevant journaling function is inactive. 

Q UERY PAGING 

PAGING nn, SET mm, RATE nnn/SEC INTERVAL=hh:mm:ss 

— or for attached processor application — 

PAGING HP-nn/AP-nn, SETmm, RATE nnn/SEC INTERVAL=hh:mm:ss 

where; 

nn specifies the percentage of time the processor was in page 
wait during this time interval. 

mm is the system paging activity index (threshold value) . This 
value affects the paging rate and degree of multiprogramming 
that VH/370 tries to attain. The value mm is normally 16. 

HP-nn specifies the percentage of time the main processor was in 
page wait during this time interval. 

AP-nn specifies the percentage of time the attached processor was in 
page wait during this time interval. 

nnn/SEC is the current CP paging rate in pages per second. 

hh:mm:ss is the time interval between the issuance of QUERY PAGING 
commands. 
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QOERY PRIORITY userid 

userid PRIORITY = nn 

nn is the the assigned priority of the specified user. The lower the 
value, the higher the priority. 

QDERY SASSIST 

S ASSIST /OH \ 
\OFF/ 

OH or OFF indicates that the virtual machine assist (and the virtual 

interval timer assist portion of VH/370 ECPS - if the 

processor is so equipped) is active or inactive (or not 
available on the system) . 

QOERY SASSIST (attached processor applications) 

SASSIST /OH ) PROC nn, /OH ) PROC nn 
tOFF/ (OFF/ 

OH or OFF indicates that virtual machine assist (and the virtual 
interval timer assist portion of VH/370 ECPS - if the main 
processor or the attached processor is so equipped) is active 
or inactive for the designated processor, PROC nn. 

nn can be any hexadecimal value from 00 to 3F. The response is 
indicated in hexadecimal values. The values assigned to the 
main processor and the attached processor are assigned by the 
installation when the system hardware is installed. 

Hote: To determine if the expanded virtual machine assist portion of the 
VH/370 Extended Control-Program Support is active requires a positive 
response to both QOERY CPASSIST and QOERY SASSIST commands. 

QOERY AFFIHITY [userid] 

OSER PROCESSOR AFFIHITY 
userid affinity 



where ; 

userid is the user identification of the virtual machine. 

affinity is the address of the processor (main or attached) that will 
execute the virtual machine instructions. Affinity can be any 
hexadecimal value from to 3F. The processor address is set 
when the System/370 processors are installed. In attached 
processor systems, the processor addresses are unique. If 
HOHE is indicated in the response, no affinity is set and the 
virtual machine is dispatched for execution on the first 
available processor. 

Hote: In System/370 Model 168 installations, the role of 
attached processor and main processor can be reversed by a 
console switch setting. 

122 VH/370 Operator 1 s Guide 



The format of the Class B QUERY command is: 




DAsd 



jSysvirtl 
j Virtual I 



TApes 

LINES* 

OR 

GRaf 

ALL 

DAsd volid 

TDsk 

STORage 

raddr 

SYStem raddr 

DUMP 



lACTiye | 
|OFFline| 
IFREe | 
(ATTach I 
I ALL | 

L J 



lQuery LINES is not effective for 3704/3705 resources unless the 
3704/3705 is operating in 270x Emulation Program (EP) mode- For 
3704/3705 Communications Controllers operating in Network Control 
Program (NCP) or Partitioned Emulator Program (PEP) mode, use the 
! NETWORK QUERY command. { 

■ : 1 



where; 

DASD 

I SYSVIRT 
I 

| VIRTUAL 
I 

TAPES 

LINES 

UR 

GRAF 
ALL 

DASD volid 
TDSK 



displays the real addresses of disk or drum devices. 

displays the addresses and specified status of 3330V devices 
that have the SYSVIRT feature. 

displays the addresses and specified status of 3330V devices 
that have the VIRTUAL feature. 

displays the real addresses of magnetic tape units. 

displays the real addresses of communication lines. 

displays the real addresses of unit record devices (card 
reader, card punches, printers) . 

displays the locally attached display devices. 

(used as a first operand) displays all devices and the size of 
re-r \ storage. 

I 

displays the active or free status of the specified DASD 
volume. 

displays all the currently allocated temporary disk space 
(TDSK) from all available system-owned volumes assigned to 
virtual machine users. 



STORAGE displays the size of real storage, 



I raddr displays forms name and image library name 
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SYSTEM raddr 

displays the userid, virtual address, and access mode of 
virtual disks which reside on the specified channel and 
control unit address raddr belonging to logged-on users. 

DUHP displays at the operator's terminal the type of device and 
device address of the unit designated to receive abnormal 
termination dumps. 

ACTIVE displays the status of only the active devices within the 
group specified. This is the default. Active devices do not 
include devices that are "free" or "offline". An active 
device is one that is in use by a user or the system. 

OFFLIHE displays only the devices in an "offline" status within the 
group specified. An offline device is one that is not 
available for access by any user or the system. 

FREE displays all the devices that are not currently in use by the 
system or a user on the system. Free devices do not include 
"offline" devices. A free device is one that is not in use by 
a user or the system. 

ATTACH displays all the devices that are dedicated to any user on the 
system. An attached device is also an active device. 

ALL (as the second operand) displays the status of all devices 
within the group specified. The status is typed in the order 
of "active", "free", and "offline" and is equivalent to the 
response from entering 

QUERY type ACTIVE 
QUERY type FREE 
QUERY type OFFLIHE 



Responses to the Class B QUERY Comm and 



flUERY DASD 



DASD raddr ATTACH TO userid vaddr 

is displayed if the real device specified by raddr is attached 
to a user's (userid) virtual machine at virtual address vaddr. 

DASD raddr CP SYSTEM volid nnn 

is displayed if the real device designated by raddr is allocated 
to the system for use as user's minidisks, nnn is the number of 
active user's minidisks on the physical disk and volid is the 
volume serial number of the real disk. 

DASD raddr CP 01HED volid nnn 

is displayed if the real device designated by raddr is used by 
the system for paging and spooling activity, nnn is the number 
of active user's minidisks and T-disks (if any) on the physical 
disk and volid is the volume serial number of the real disk. 
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QUERY TAPES 

TAPE raddr CP SYSTEM 

is displayed if the real tape device designated by raddr is 
attached to CP for its exclusive use. 

TAPE raddr ATTACH TO userid vaddr 

is displayed if the real tape device designated by raddr is 
attached to a user's (userid) virtual Machine at virtual address 
vaddr. 



QUERY LINES 

/LINE) raddr LOGON AS userid 
(CONS J 

indicates that the user represented by userid is currently 
logged on at the terminal located at real address raddr. 

LINE raddr ATTACH TO userid vaddr 

indicates that the communication line at raddr is attached to 
the virtual machine represented by userid at virtual address 
vaddr. 



QUERY UR 

(PRT\ /STARTED) (SEP ) 

(PUNj raddr (DRAINED J SYSTEM CLASS = a... (NOSEP J 

( STARTED ) 
RDR raddr \ DRAINED) SYSTEM 

is displayed for each unit record device assigned to the system for 
spooling activity. 

w here : 

raddr is the real device address (cuu) . 

DRAINED indicates that the device is not currently available for 
processing. A START command must be issued to activate the 
device. 

STARTED indicates that the device is available for spooling activity. 

a... specifies the classes serviced by the output device. Up to 
four classes may be serviced by an output device. No blanks 
or commas are allowed between classes. 

NOSEP indicates the device was started with the NOSEP option. 

SEP indicates the device was started without the NOSEP option. 

Section 3. CP Commands 125 



Mote: The separator (SEP) option applies to printer output where the 
edge of the fanfolded continuous forms are heavily printed. This 
indicates to the spooling operator the beginning and end of adjacent 
spool files. 



(PRT ) 
^ PUN J> r< 



raddr ATTACH TO userid vaddr 

( SDR j 

is displayed if the device is attached to a user's virtual machine at 
vaddr. 

If the unit record device is currently active with a spool file, the 
following additional response is also given: 

(PRT) (PRINTING) 

(PON J raddr \ PUNCHING J userid FILE = file RECDS = norecs COPY = nn a typ 

RDR raddr READING userid FILE = file 

wh ere : 

userid is the nane of the spool file owner. 

file is the spool file spoolid number. 

norecs is the total file logical record count. 

nn is the number of copies remaining for output, where 01 
indicates the last copy. 

a is the spool file class. 

typ is the originating device type (PRT, PON, CON) . 



QUERY GRAF 

GRAF raddr LOGON AS userid 

indicates that the user represented by userid is currently logged on at 
the terminal located at real address raddr. 

GRAF raddr ATTACH TO userid vaddr 

indicates that the display device at real address raddr is attached to 
the virtual machine represented by userid at virtual address vaddr. 

O.UERY ALL 

Produces the same results as if the following commands were issued: 

QUERY STORAGE 
QUERY UR 
QUERY LINES 
QUERY DASD 
QUERY TAPES 
QUERY GRAF 
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fiUIEI ty_£e OFFLINE 

This command produces a response for each offline device in the 
following format: 

type raddr OFFLINE 

Multiple responses are displayed in the following format: 

type raddr OFFLINE, ... 



Note: In the above responses the term type refers to one or more of the 
following device types: 

12PJ- Meaning 

DASD Direct access device 

TAPE Magnetic tape units 

LINE Communication line 

RDR Card reader 

PRT Line printer 

PUN Card punch 

GRAF Graphics device 

CONS Console 

CTCA Channel to channel adapter 

CTLR 3704/3705 communications controller 

DEV Any other device 

QUERY type FREE 

This command produces a response for each device that is not active or 
offline in the following format: 

type raddr FREE 

For unit record devices the response is: 

type raddr DRAINED 

Note: This response implies that no spool files are queued for this 
device. 

For communication devices the response is: 

(ENABLED ) 
type raddr \ DISABLED/ 

For DASD devices with mounted volumes the response is: 
type raddr /FREE 



/FREE ) 
\ volid / 



Multiple responses are displayed in the following format: 
type raddr FREE, ... 
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QUERY DASD volid 

The command response is given in either the "active" or "free" format 
depending upon the device status. 



£UER Y TDSK 

This command displays all the currently allocated user TDSK space from 
all available system-owned volumes. One entry of the following format 
is produced for each TDSK: 

userid vaddr nnn 

whe re: 

userid is the virtual machine identification. 

vaddr is the user's virtual device address. 

nnn is the number of cylinders allocated. 

Bote: If the operator queries any real device or group of devices (such 
as QOERI DASD) the following message occurs for all devices in a 
not-ready status and the CPU alarm rings: 

type raddr INT REQ 



QUERY STORAGE 

STORAGE = xxxxxK 

displays the size of real storage (xxxxx) in multiples of 1024 
bytes* 



I fiUERY raddr 

; This command displays the table information that is specified on a real 
I device. The format of output from this option is: 



i 

I PRT rrr 



i STARTED \ (SEP CHARS FCE) 

(DRAINED/ SYSTEM CLASS=C...\N0SEP J 

I /PURGE) 

! PRT rrr FLASH f f f f IMAGE imagelib \ HOLD ( 



I where : 

I rrr indicates the real device address. 

! STARTED indicates the device is available for spooling activity. 
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DRAIHED indicates the device is not currently available for 
processing. A START command must be issued to activate the 
device. 

c... indicates the classes serviced by the output device, 

NOSEP indicates that a file separator is not desired for the output 
file. 

The following information is displayed for the 3800 printer only: 

CHARS indicates the name of the character arrangement table used for 
the separator page. 

FCB indicates the value of the forms control buffer used for the 
file. 

SEP indicates that a file separator is desired for the output 
file. 

ffff indicates the forms overlay sheet contained in the device. 

imagelib indicates the named system image library used for tables. 

PURGE indicates a delete status for spool files containing load 
errors. 

HOLD indicates a save status for spool files containing load 
errors. 

QUERY SYSTEM raddr 

This command requests the number of user minidisks residing on the 
physical disk located at raddr. The response for each minidisk is given 
in the following format: 

userid vaddr mode, ... 



where: 

userid is the identification of the user who owns the minidisk. 

vaddr is the virtual address by which the user refers to the minidisk. 

mode is the type of access the user has: either R/0 or R/W, or nnn 
for the number of cylinders of TDSK space allocated. 



QUERY DUMP 

type raddr DUMP UNIT 



fCP ) 
\ALLj 



indicates that the device of device type "type" located at raddr 
is the system dump unit. 
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The foraat of the class D QUERY coaaand is: 




CLASS c 
userid 



HEADER 
RDR 

PRINTER 
PRT 

PUNCH 
PCH 



r t 

Files [Class c] | userid | 

I * I 

L J 



rr t •% 

Reader I I AIL | [ userid ] | 
PUnch j ICLass cj j 

I spoolid | 

L J 



rr t ~i 

Printer | |ALL | [userid] 
j ICLass cj 
IITBL | 

I spoolid 

L 

HOld 



displays the nuaber of spooled input and output files. The 
class D user receives the total count in the systea. Files 
that are currently being processed are not included in the 
totals. 

displays only the spool files of the specified class. If 
CLASS is oaitted, then all spool classes are ezaained. 

displays only the spool files ovned by the specified userid. 
If userid is oaitted, then spool files owned by all users are 
ezaained. 

displays only the spool files of the logon user who issued the 
O/UERY coaaand. 

displays basic inforaation concerning reader spool files. 



displays basic inforaation concerning printer spool files, 
displays basic inforaation concerning punch spool files. 

Note: The basic inforaation displayed is: 

• Userid of the owner of the spool file. If exaaining files 
for a specific user (userid option) , the userid indicates 
the originator of the spool file. 

• Spool file spoolid number 

• Class and originating device type 

• Number of logical records in the file 

• Nuaber of copies specified for the file 
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• File hold status 

ALL displays additional information for all spool files examined. 

spoolid displays additional information for the specified spool file. 
The spool identification (spoolid) is a VH/370-generated 
sequential number assigned to each spool file. 

The additional information displayed is: 

• Date and time the file was created 

• Filename and filetype of the file (if any) 

• Distribution code of the file 

I TBL displays table information for 3800 spool files. 

I The table information displayed is: 

I • Flash name 

j • Name of the character arrangement table 

I • Forms control buffer (FCB) 

I • Name of the copy modification module 

! • Number of copies to be flashed (flash count) 

HOLD displays a list of users whose output is being held by the 
HOLD command. 



Responses to the Class D QOERY Command 



QUERY FILES [CLass c] [userid] 



FILES: | NO \ RDR, /NO \ PRT, (NO ) PUN 
tnnnj (nnnj \nnnj 



displays the total number of spool files in the system, of a particular 
class, or for a particular userid. 



(READER 
< PRINTER 
QOERY ! PUNCH 
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-Basic Information- 



| ! Additional Information 

It 

I DATE TIHE 



▼ I 



NAME TYPE DIST | 
|mm/dd hh:mm:ss name type code | 



▼ v I 

OWNERID* FILE CLASS RECDS CPY HOLD | r 
userid file a typ norecs nn stat |v 



-Table Inforiation- 



1 i 

t| 

IFLASH CHARS FCB MDFY FLSHC | 
jovly ctab plpi cmod cc j 

L J 



Only one file is listed for a QUERY READER, QUERY PRINTER, or QUERY 
PUNCH command if the spoolid operand is specified. 

The DATE, TIME, NAME, TYPE, and DIST information is displayed only when 
the following commands are issued: 

QUERY (READER ) (ALL 1 
< PRINTER } \ spoolid J 
( PUNCH j 

| FLASH, CHARS, FCB, MDFY, and FLSHC information is displayed for the 3800 
I printer only. This information is obtained by issuing the following 
I commands: 



QUERY PRINTER TBL 

whe re: 

userid is the identification of the user who owns the file. 

file is a unigue, system-assigned number which is used by 
VM/370 to identify the file. 

a is the spool file class. 

typ is the originating device type (PRT, PUN, CON, or 
RDR). 

norecs is the number of logical records contained in the 
file. 

nn is the number of copies specified for the file. (Has 
no effect for reader files.) 

stat is the file hold status and is either 

NONE - no hold 
USER - user hold 

mm/dd is the date the file was created in month/day. 

hh:mm:ss is the actual time of the creation of the file in 
hours: minutes: seconds. 



1 OWNERID heading the title line for the spool file data is altered to GRIGINID 
when the userid operand is used. In that event, ORIGINID represents the 
originator of the file. 
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filename is the filename assigned to the file (if any) . If the 
file has a 24-character data set name (dsname) , only 
20 characters are displayed. These characters extend 
from the "name" field through the "type" field. 

f iietype is the filetype assigned to the file (if any) . 

distcode is the distribution code of the file. 

ovly is the one- to- four character name of the flash overlay 
sheet loaded into the 3800 printer. 

ctat is the one-to-four character name of the character 
arrangement table to be used for the separator page. 

plpi is the print lines/inch value to be used for the 
separator page. 

cmod is the one-to-four character name of the copy 
modification module to be used for printing the file. 

cc is the flash count for the file. 



QOERY HOLD 



HOLD : (NO ) RDR, (NO ) PRT, (NO ) PON 
\nnnj \nnnj \nnnj 




userid - 



The first response displays the total number of files within the 
system which are retained in the system hold status. The second 
response indicates the type of hold (if any) for any user in the 
system for which HOLD is in effect. The user who issues QOERY 
HOLD may receive, depending upon the status of his spooled 
files, the first response, the second response, or both 
responses. 

The format of the Class A, B, C, and E QOERY command is: 

1 

I 

1 



I Query 



I PROCessor 



wh ere ; 

PROCESSOR displays the online processors in the system. 

Response to the Class A, B, C f and E Query Command 

PROCESSOR nn ONLINE [, PROCESSOR nn ONLINE] 

displays the processors that are online. The first processor is the 
main processor. 
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The format of the Class A, B, C, D, E, and F QUERY command is: 



I Query 



I 



jLOGasg 
lHames 
YUsers 
(userid 



[userid ] 



wh ere : 
LOGMSG 
NAMES 

USERS 



userid 



displays the system log messages of the day. 

displays a list of all the users logged on and the real 
address of the line to which each is connected. If the user 
is disconnected, DSC is displayed instead of the line address. 

displays the number of logged-on users and the number of users 
dialed to other virtual machines. If userid is specified, the 
userid and device address of the use^s terminal are displayed 
if he is logged on. If the specified user is not logged on, a 
message to that effect occurs. Use the USERS operand if the 
userid is the same as an operand (or its minimum truncation) 
of the QUERY command. 

Note: It is possible for the number of users logged on as 
indicated by the NAMES operand to differ from the number 
logged on as indicated by the USERS operand. The number of 
users in the process of logging on and logging off accounts 
for this difference. 

displays the userid and the device address of the user*s 



terminal if he is logged on. If 
message to this effect occurs. 



the user is not logged on, a 



Re spo nses to the A, B, C, D, E, and F QUERY Command 
QUERY LOGMSG 

* logmsg text line 1 

* logmsg text line n 

logmsg additional text lines 



All liues (both those with and without an asterisk) 
message file are displayed. 



.n i.uc ->-cg 
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QUERY NAMES 



userid - / DSC \, ... 
\ raddr J 



userid - /DSC ), ... 



\radd] 

Lists all logged- on users. If the user is currently connected, 
the real address to which he is connected is displayed (raddr) . 
If he is not connected to the system, DSC is displayed. 



QUERY USERS 

nnn USERS, mmm DIALED 

where; 

nnn is the total number of logged on users. 

sss is the total nusber of users logically attached via the 
DIAL command to virtual Machines. 

Hote; The term DIALED leans that the line is not available to CP because 
it is logically attached to a logged-on user and is a part of that 
user's virtual Machine operation. 

QUERY userid 

userid - raddr 

displays the real address (raddr) to which the specified user is 
connected. 
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REPEAT 



Pr ivil ege Class: D 



Use the REPEAT command to: 

1. increase the number of copies of an output file beyond that 
quantity originally requested by the file's creator. 

2. Place the current output file in a HOLD status, with or without 
increasing the number of copies to be created. 

This conand applies to files currently being written to a real punch 
or printer. The format of the REPEAT command is: 



REPeat 



raddr 



1 r i 




i mm 




i ii i 




i L j 




1 r t 




1 lnn| 


HOld | 


1 L J 





where: 
raddr 

nn 
HOLD 



is the address of the output device (printer or punch) whose 
current active spool file is to be repeated or held. 

is the number of extra copies of the current file that are to 
be made. If nn is omitted and the HOLD operand is not 
specified, the number of extra copies defaults to 1. The 
maximum value that may be specified for nn is 99. 

holds the file currently being printed or punched. If nn is 
not specified and HOLD is specified, when the last copy has 
been completed, the file is placed in system hold status until 
it is explicitly released. 

Note: All copies indicated by a SPOOL command or by a previous 
REPEAT command are printed before the HOLD operand takes 
effect. 



Responses 



(PRT) (REPEATED ) 

tPON/ raddr |FILE HELD/ userid FILE = file RECDS = norecs COPY = nn a typ 

The FILE HELD response is given in addition to the REPEATED response if 
the HOLD operand is specified. 



136 YM/370 Operator's Guide 



where: 

raddr is the real address of the device whose current output is 
being repeated. 

userid is the identification of the user who is to receive the 
output. 

file is the unique, system-assigned spoolid number by which 
VH/370 refers to the file. 

norecs is the total number of logical records in the file. 

nn is the remaining number of copies of the file to be 
created, where 01 is the last copy. 

a is the spool file class. 

typ is the originating device type (PRT, COH, or PON) . 
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SAVESYS 

Privilege Class: E 

Use the SAVESYS command to save a virtual machine storage space with 
registers and PSff as they currently exist. This command is used in the 
process of creating named systems. The format of the SAVE5IS command 
is: 



I SAVESTS | systemname 

l ; 



where: 

systemname 

must be a predefined name representing a definition of 
installation requirements of the named system. The definition 
indicates the number of pages to be saved, the DASD volume on 
which the system is to be saved, and the shared segments (if 
any) . SAVESYS should be invoked immediately after loading the 
system that is to be saved (while it is in a stopped state) . 
Refer to the discussion of named systems in the VH/370 System 
Programmer's Guide for further information concerning saved 
systems. 



Responses 
SYSTEM SAVED 
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SET 



Privilege Classe s : A, B, or F 



Use the SET command to establish system parameters. The SET command 
performs various functions to control the CP system and virtual machine 
options. 

The format of the Class A SET command is: 



r t 

AFFinity [userid] |0N I 

I OFF | 
Inn | 

L J 



CPAssist 



ON ) 
OFFj 



SET 



r t 

FAVORed userid |xx | 

I OFF | 



w .1 



Journal 1 (LOgon) ION | 

(Link J |OFF| 

i j 

REServe userid (XX ) 

(OFF j 



SASsist 



JON ) [[PROC[nn]] 
(OFF j 



PRIORity userid nn 



*The JOURNAL operand is valid only if STQUERY=YES is specified in 
the STSJRL macro instruction DMKSYS. 



where: 

AFFINITY [userid] | ON | 

I OFF | 
Inn | 

L J 

(Attached processor system only) sets affinity for the 
specified userid. If userid is omitted, affinity is set or 
reset for the user who issued the command. If ON is specified 
(specifically or by default) , the value in the user's 
directory entry is used. The value nn must be the hexadecimal 
(00— 3F) processor address of an' installed processor of an 
attached processor system. Affinity restricts execution of 
the virtual machine to the specified processor, but does not 
restrict CP code executed on behalf of a virtual machine to 
any processor. 
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CPASSIST (ON \ 
[OFF/ 
sets CP assist to the active or the Donactive state. If CP 
assist is active, functions normally executed by various 
sections of CP routines are executed by processor hardware 
logic. This function lade active on VM/370 initialization, a 
part of VH/370 Extended Control-Prograi Support (VM/370 ECPS) , 
is available on Systea/370 models 135-3. 138. 145-3. and 148. 

Expanded virtual machine assist, another part of VH/370 ECPS, 
is also controlled by the SET CPASSIST ON and OFF operands. 
Expanded virtual machine assist, an extension of function 
provided by virtual machine assist, is set to the active state 
upon VM/370 system initialization. Thereafter, to enable this 
function, both SET CPASSIST ON and SET SASSIST ON commands 
must be invoked. To set expanded virtual machine assist to 
the inactive state, use either SET CPASSIST OFF or SET SASSIST 
OFF. 

r t 

FAVORED userid |xx I 
I OFF | 

L J 

sets the favored execution performance option for the 
specified user (userid) . The FAVORED function with percentage 
(xx) specified can be in effect for only one virtual machine 
at any time. If xx (percentage values from 1 to 99 are valid) 
is specified, VM/370 attempts to provide up to the specified 
percentage of processor time to that virtual machine, provided 
that virtual machine can fully utilize the processor time. At 
regular time intervals, the VM/370 dispatcher checks the 
processor time used by the particular virtual machine; if the 
percentage has been exceeded, the virtual machine is given his 
normal priority usage for the remainder of the interval. If 
the percentage is lov, the virtual machine is assigned highest 
priority for the remainder of the interval. If OFF is 
specified, the specified virtual machine is removed frcm 
FAVORED status. If neither xx nor OFF is specified, the 
virtual machine designated is always dispatchable; that is, 
any time it is ready to use processor time, it is given 
preference over other users with the same priority. Multiple 
users may be classified as favored if they have no percentage 
assigned; however, only one user may be designated in a single 
SET command. 



r t 

JOURNAL /LOGON ) |0N ! 
(LINK / | OFF | 

I J 

sets the status of the LOGON and LINK journaling functions. 

RESERVE userid / xx ) 
\OFFj 
sets the reserve** page performance option for the specified 
user (userid) . This performance option can be applied to only 
one virtual machine at any time. The specified virtual 
machine uses only the specified number of page frames (xx) for 
its exclusive use. If the number of page frames does not 
egual the most active pages, the virtual machine will 
experience performance degradation. The page frames are not 
locked and the virtual machine can also use other available 
page frames; however, no other virtual machine can use a 
reserved page frame unless all other available page frames 
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have been exhausted. The maximum number of page frames 
reserved is limited by the size of the virtual machine. The 
OFF operand returns the reserved pages to the system. 

SASSIST /ON \ [[PROC]nn] 
(OFF/ 

controls whether virtual machine assist, a facility available 
on most VM/370 supported System/370 processors, is activated 
or deactivated for the entire system. In VM/370 attached 
processor applications, virtual machine assist may be set 
either ON or OFF for the desired processor by selecting the 
PHOC nn operand. If PROC nn is not selected then SET SASSIST 
ON or OFF determines the setting of virtual machine assist for 
both the main and the attached processor. The values of nn 
are processor addresses (hexadecimal values 00 to 3F) 
established when the System/370 is installed. If nn equates 
to a value that is not the address of the main processor or 
attached processor, an error message is issued. Virtual 
machine assist increases the efficiency of CP processing of 
certain instructions, privileged instructions, and interrupts 
reflected to CP. 

SET SASSIST in conjunction with CPASSIST also controls whether 
the VM/370 Extended Control-Program Support provided by 
System/370 Models 135-3, 138, 145-3, and the 148 is in an 
active or inactive state. For details on how this is 
accomplished, refer to the CPASSIST operand previously 
described. VH/370 Extended Control-Program Support simulates 
the CP processing of additional privileged instructions and 
extends the level of handling of other privileged instructions 
not covered by virtual machine assist. SET SASSIST ON or OFF 
also controls whether the virtual interval timer assist 
function of ECPS, a hardware updating facility for the 
interval timers of virtual machines, (virtual location X*50') 
is available to users. Ose of this timer hardware update 
facility by the virtual machine is controlled by the class G 
command SET ASSIST THE or SET ASSIST NOTMR; for details, see 
the VM/370 CP Command Reference for General Users. 

Opon system initialization, the default value SET SASSIST is 
ON for VM/370 processors except the System/370 Model 155 II 
and the 165 II« 

For details on the extent of virtual machine assist and the 
VM/370 Extended Control-Program Support, refer to the VH/370 
System Programmer's Guide. 

PRIORITY userid nn 

sets the priority of the specified user (userid) to the 
desired value (nn) . This value affects the user's dispatching 
priority in relation to other users in the system. The 
priority nn value is one of the factors considered in VH/370' s 
dispatching algorithm. Generally, the lower the value of nn, 
the more favorable the user's position in relation to other 
users in VH/370's dispatch queues. 
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The format of the Class B SET command is: 




where: 



LOGMSG 



r t 

Inn I 
| NOLL | 

L J 

LOGMSG or LOGMSG nn causes CP to respond with the message 
LOGMSG: followed by a console read to allow the operator to 
enter the line. The maximum log message length per line is 76 
characters, including spaces. Ose LOGMSG with no operand to 
start a new log message or add to a log message. LOGMSG nn 
specifies that a change is to be made to existing line number 
nn in the log message. A null line entered terminates the 
LOGMSG entry (for adding or initializing) or deletes line nn 
if that option is used. LOGMSG NULL deletes the entire 
existing LOGMSG allowing a new LOGMSG to be created. 
Preceding the message text with an asterisk automatically 
displays the message on the console as soon as a user logs on 
to 7M/370. 



DDMP (AUTO \ |CP | 
( raddr J |ALL| 



designates the unit to receive the VM/370 system ABEND dump, 
where raddr is a real printer or a 9-track tape address. If 
the dump unit is a tape drive, the dump data must fit on one 
reel because VM/370 does not support multiple tape volumes. 
If AUTO is specified, the system dumF unit is disk. The CP 
option dumps only storage occupied by the control program/ 
whereas the ALL option dumps all storage. 
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The format of the Class F SET command is: 



SET ! RECord {OFF r 

ON raddr LIBIT nn BYTE nn BIT 



n l/AND) 
1 1 OR f 



BYTE nn BIT n! 



MODE (RETRY) /Quiet \ [cpuid] 
(MAIN J (Record/ 



wh ere : 
RECORD 



sets the recording mode for a device. ON allows 
user to specify intensive recording mode for the 
LIMIT identifies the value at which a recording 
and the BYTE and BIT operands define the test con 
sense bytes. Two bits may be tested by an 
relationship. The OFF function turns off intens 
mode. Only one device at a time may have intens 
specified. If SET RECORD OFF is not entere 
recording is automatically terminated after the 
of ten error records for that device. 



the class F 
device raddr. 
will be made, 
dition in the 
AND or OR 
ive recording 
ive recording 
d, intensive 

accumulation 



MODE sets the error recording mode for soft errors. Soft errors 
are recoverable processor storage or instruction errors 
corrected by hardware or software logic. 

MODE RETRY QDIET turns off error recording for soft machine 
check errors successfully corrected by instruction retry. 

MODI RETRY RECORD resets the error threshold count to zero and 
records soft machine check errors (up to the threshold of 12) , 
successfully corrected by instruction retry, on the error 
recording cylinder. 

MODE MAIN QUIET turns off error recording for single bit main 
storage errors, successfully corrected by Error Correction 
Code logic. 

MODE MAIN RECORD resets the error threshold count to zero and 
records up to 12 successfully corrected main storage errors on 
the error recording cylinder before entering MAIN QUIET mode. 

Note: SET MODE MAIN is invalid for 3031, 3032, and 3033 
processors. 

cpuid in attached processor mode, indicates the address of the 
processor for which the command is executed. If no address is 
specified, the command is processed for both processors. If a 
value is specified, it must be in agreement with the processor 
designated identity specified at the time of the installation 
of the processor complex. Valid hexadecimal values are GO to 
3F. 



There are no responses to the SET command. However, when the command is 
invoked, information messages related to the use of specific SET 
operands are displayed. These messages are described in the VM/370 
System Messages. 
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SHUTDOWN 

Privilege Class: A 

Use the SHUTDOWN command to systematically end all VM/370 functions and 
to checkpoint the system for an eventual warm start. This is the normal 
method to shut the system down. All VM/370 functions are suspended and 
communications lines are disabled. Use the NETWORK SHUTDOWN command to 
stop communications on 370x or remote 3270 binary synchronous lines. 
The format of the SHUTDOWN command is: 



i 1 

| SHUTDOWN | I 

i 1 

This command has no operands. 
Usage Notes: 

1. Because the SHUTDOWN command stops all virtual machine operation, 
any knowledge of an impending shutdown situation on the part of the 
system operator should be conveyed to the virtual machine users as 
soon as possible via appropriate LOGMSG information, messages and 
warnings so they may quiesce their virtual systems in an orderly 
manner. 

2. In VM/370 installations that use the 3850 Bass Storage System, the 
VM/370 shutdown process issues a SUSPEND order to all 3851 devices 
to suspend the MSC interface. Note, the SUSPEND order may cause 
the shutdown process to take longer than usual as it causes the 
destaging of data on 3330V volumes. 

Responses 

SYSTEM SHUTDOWN COMPLETE 
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SPACE 

Privilege Class: D 

Dse the SPACE command to force the output on the specified printer to be 
single spaced for the current active spool file, regardless of the 
carriage control comiands contained in the actual file. The format of 
the SPACE command is: 



i 

I SPAce | raddr 
i 



where: 



raddr is the real address (cuu) of the printer whose output is to be 
single spaced. 



Responses 



None. 
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START 



Pr ivi lege Class: D 



Use the START command to restart a spooling device after it has been 
drained, or to change the output class that it may service. If the 
device is busy vhen the conand is given, the changed Classes take 
effect after the current file is complete. The format of the START 
command is: 



STArt 



Printer 

PDnch 

Reader 

raddr [CLass c 



r n 

] [NOsep] IFLash name 
ICHars name 
|FCB name 
linage namedsys 
I PUrge 

L 



ALL 



where: 



PRINTER 
PRT 



starts or changes the status of the printer. 



PUNCH 
PCH 



starts or changes the status of the punch. 



READER 
RDR 



starts or changes the status of the reader. 



raddr is the address (cuu) of a particular spooling device which is 
to be started. Hore than one device may be specified. 



CLASS c. 



specifies the output classes the specified device is allowed 
to service. From one-to-four classes (single characters with 
no interrvening blanks) may be specified. If multiple classes 
are specified for a device, output files receive service by 
the device in the order that the classes were specified. For 
example, if the option: 

CLASS AD1 

is specified for a printer, all class A files are spooled 
before class D files, and all class D before class 1. 



Note: a class of * can be specified for printers or punches so 
that any spool file class can be serviced by the device for 
output. 

NOSEP specifies that no file separator is desired for the output 
files. If not specified, a separator is produced. If NOSEP 
is specified for the punch, separator cards are not punched; 
instead, the operator receives the message: 

PUN raddr START FOR OUTPUT 
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The punch can then be started for the next file by issuing the 
CP START command or physically activating the START/STOP key 
on the device. 

FLASH name 

specifies the flash overlay sheet loaded into the device. 
Hame may be from one-to— four characters in length. 4 

CHARS name 

specifies the character arrangement table used for the 
separator page. Name may be from one— to-four characters in 
length.* 

! FCB name specifies the forms control buffer used for the separator page 
j and also for any spool file for which an FCB has not been 

| specified (through the use of the SPOOL or CHANGE command) . 

| name may be number 6, 8, or 12. These specifications mean; 

print the entire spool file at 6, 8, or 12 lines per inch, 

regardless of the size of the paper that is currently loaded. 

Use of the unigue numbers will never cause an FCB— forms 

mismatch. 1 

IMAGE namedsys 

specifies the named system image library used for tables. 
Namedsys may be from one— to— eight characters in length and 
must be a valid named system. 1 

PURGE specifies that all files with load errors be purged. If not 
specified, all files will be held. 

N ote : The FLASH, CHARS, FCB, IMAGE, and PURGE options are 
valid only for the 3800 printer. 

ALL starts or changes the status of all readers, printers, and 
punches. 

Note ; Printers and punches that are in a ready status with files 
available for processing immediately start to produce output when the 
START command is issued. Readers, however, do not start until a card 
deck is supplied and the device is made ready. 



Response s 

(PRT) raddr STARTED SYSTEM CLASS = a... (SEP ) 
iPUNj \N0SEPj 

RDR raddr STARTED SYSTEM 

where : 

raddr is the real device address of the device started. 

a... indicates the classes to be serviced by the device. 



ilf not specified, the last value specified by the installation is used. 
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STCP 



Privileg e Class : C 



Use the STCP command to alter the contents of real storage- The real 
PSW or real registers cannot be altered with this command. In a system 
running in attached processor mode, data in shared pages cannot be 
modified by the use of this command. The format of the STCP command is: 




hexloc] 

Mhexloci 

Nhexloc( hexwordl [hexword2. 

Lhexloc/ 
MLhexloc* 
NLhexloc 



Shexloc} 
MShexloc> hexdata 
NShexloc) 



where: 



hexloc 

Hhexloc 

N hexloc 

Lhexloc 

MLhexloc 

NLhexloc 



stores the data given in hexwordl [hex 
fullword locations starting at the 
hexloc. The smallest group of hexadec 
stored using this specification is o 
aligned to the nearest fullword bounda 
stored is less than a fullword (eight 
is right-adjusted in the word and the 
word are filled with zeros. 



word2...] in successive 
address specified by 
imal values that can be 
ne fullword. Data is 
ry. If the data being 
hexadecimal digits) , it 
high order bytes of the 



In attached processor syst 
treated as absolute addres 
hexadecimal address causes 
through the prefix register 
N prefixing an address fu 
prefix register for the att 
the attached processor is 
system was generated for 
operation. 



ems, hexloc and Lhexloc values are 

ses. The letter M prefixing the 

that address to be interpreted 

of the main processor. The letter 

notions the same way through the 

ached processor. N is valid while 

in operation. M is valid if the 

the attached processor mode of 



Shexloc 
MS hexloc 
NShexloc 



stores the data given in hexdata in the address specified by 
hexloc without word alignment. The shortest string that can 
be stored is one byte (two hexadecimal digits) . If the string 
contains an odd number of characters, the last character is 
not stored. An error message occurs and the function ends. 
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HShexloc and HShexloc operands are used in attached processor 
VM/370 applications. By prefixing Shexloc with M or N, the 
specified hexadecimal addresses are interpreted through the 
associated prefix registers of the main or the attached 
processor, respectively. 

hexword specifies up to eight hexadecimal digits. If less than eight 
digits are specified, the string is right-justified in a 
fullword and left-filled with zeros. If two or more hexwords 
are specified, they must be separated by at least one blank. 

hexdata specifies a string of two or more hexadecimal digits with no 
embedded blanks. 

Dsage Notes; 

STCP H6U 20000 

stores X' 00020000* into the second word of the SVC new PS! in the PS1 
(prefix storage area) of the attached processor. 



STORE COMPLETE 
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TRANSFER 

Privilege Class; D 

Use the TRANSFER conand to direct one or more reader spool files to a 
specified user's virtual reader or to reclaim reader spool files that 
were previously sent to one or more users. The file is deleted fron the 
sender's virtual card reader and is available in the recipient's spooled 
reader. The format of the TRANSFER command is: 



i 

I I r n r t 

I TRANsfer | | user id | (spoolid) |To | / userid ) 
| | | SYSTEM | {CLass c> |FROM| (ALL J 

I | c j (ill ) t j 



where: 

userid is the user identification of the user whose reader spool 
files are to be transferred or reclaimed. 

SYSTEM allows the spooling operator to manipulate all reader spool 
files in the system regardless of the userid. 

spoolid is the identification of the file to be directed to or from 
the named userid. 

CLass c transfers all files of the given class. 

ALL transfers all reader spool files. 



To 



/ userid 1 
( ALL I 



is the user to whom the files are to be directed. If the 
optional keyword TO is omitted, userid cannot be T or TO. ALL 
cannot be specified with TO. 



FROM /userid) 



(ALL 

is the user from whom the spool reader files are to be 
reclaimed. ALL may be specified to reclaim files from all 
users that were originated by the userid specified first. 



Responses 

RDR FILE spoolid TRANSFERRED /TO ) userid 

(FROM/ 

where: 



;pcclid is the reader spool file number of the file that 
transferred. The number does not change. 



TO is the response to the user that currently owns the spool file 
and userid is the recipient. 

FROM is the response to the user that receives the transferred 
spool file and the userid of the sender. 
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( nnnn ) 
\N0 / 



FILES TRANSFERRED 



This is the response to the user who issued the TRANSFER command. 

Note: This response is suppressed if the virtual machine user has issued 
the SET IMSG OFF command. 

The system operator, monitoring the RSCS virtual machine for his 
installation, should not specify this option because information 
messages are required for accurate monitoring of RSCS system activity. 
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UNLOCK 



Privilege Class: A 



Use the UNLOCK command to unlock page frames previously locked by a LOCK 
command. The format of the UNLOCK command is: 



UNLOCK 



userid 



SYSTEM 



firstpage lastpage 



VIRT=REAL) 
v=R J 



wh ere : 

userid is the user identification of the virtual user previously 
specified in a LOCK command. 

SISTEH specifies to unlock a previously locked pageable CP nucleus 
page. 



firstpage 



lastpage 



is the hexadecimal value of the first page to be unlocked. 



is the hexadecimal value of the last page to be unlocked. 



Note: For firstpage and lastpage, only the page numbers are 
specified. For example, to unlock USERA's virtual storage 
locations X 1 12000* to X^CFFF', the following command should 
be issued: 

UNLOCK USERA 12 2C 



7IRT=REAL 
V=R 



releases for normal paging use all the page frames normally 
for the virtual=real machine if the area is not occupied by a 
virtual=real virtual machine. 

Note: Once the virtual=real area is released, it cannot be 
reactivated to run another virtual=real machine until VM/370 
is loaded again. 



Rocnnncg 



COHMAND COMPLETE 



occurs even if some (or all) of the pages unlocked were not 
previously locked. 
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V e\ rl I 

Privilege Class: B 

Use the TART coaiand to lark a device available or unavailable for use 
by a user or the control prograi. (For 370x resources running in HCP or 
PEP iode, or reiote 3270 resources, use the NETWORK VARY com a and.) 
Spooled unit record devices larked offline are reieibered by the VH/370 
system through any systei failures. A shutdown and subsequent cold 
start assumes that all devices are available. The fonat of the VARY 
coamand is: 



VARY I (ONLine ) ( raddr-raddr ) I 

I (OFflineJ <| raddr... > I 

I (PROCessor nn ) I 

1 



where: 

ONLINE lakes a device (s) previously offline available. 

OFFLINE makes the device (s) unavailable. 

raddr is the real address of the device whose status is to be 
altered. Multiple devices as well as a range of device 
addresses Bay be specified. 

PROCESSOR nn 

is the processor to be aade available or unavailable. The 
value of nn is the processor address (hexadecimal value froa 
00 through 3F) established when the processor is installed. 

Dsaqe Notes : 

1. If the device specified is a 2305, the address aust be for the 
first of 8 "exposures," that is, address xxO or xx8. 

2. Execution of the VARY device address (raddr) command is 
accomplished in two phases. In phase one, the command line is 
checked to see if it is syntactically correct. If it is not, the 
command line is rejected. If the coimand line is correct, then the 
VARY ONLINE/OFFLINE process begins. When processing Multiple 
devices or a range of devices, VARY coaaand processing continues 
regardless of whether or not an error is encountered when 
atteapting to vary any one of the devices online/offline. An error 
■essage will be issued for every device that encounters an error 
situation. An inforaational aessage will be issued for those 
devices in the range or those multiple addresses on the coamand 
line that could be varied online/offline. 

3. Execution of the VARY PROCESSOR nn conand is accoiplished as 
follows. Conand processing checks the conand authority and 
syntax and that the specified processor nuiber is valid. If the 
coaaand is to vary the processor online, a check will be aade to 
see if it is already online. If it is not, and if the processor is 
available and operational, coaaand processing will establish 
prefixing, initialize the control registers and prefix areas, and 
set the clock coaparator and CPU tiaer; the systea can then 
function in attached processor aode. 
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If the command is to vary the processor offline, a check will be 
■ade to see that the specified processor is not the main processor 
and that it is online and operational. It will then be taken 
offline, processing will be guiesced on the specified processor, 
and the control registers and prefix register will be cleared. 
Those users having affinity to the specified processor will be 
notified that the affinity is set off; these users will then be put 
in console function mode. 

i». It is recommended that if system performance monitoring is taking 
place, it should be stopped with a HON STOP command and restarted 
after the configuration change is complete. 

5. If the system mode switch is set to UP mode, make sure you stop the 
online processor, set the switch to MP, and then vary the offline 
processor online. 



Responses 



{raddr-raddrj \0FFLIHEJ 

One or more of the previous message responses will be sent to the system 
operator depending upon errors encountered in the command execution 
phase; see Usage Note 2. 

RADDR HISSING OR INYALID 

is issued if the PROCESSOR operand was entered without a processor 
number, or if the specified number is invalid. 

PROCESSOR nn DOES NOT EXIST 

is issued if the processor specified by nn in the V1RT PROCESSOR nn 
command is not defined to the system. 

VARY PROCESSOR COHHAND FAILED 

if the VARY OFFLINE PROCESSOR nn command was entered, this response 
Indicates the specified processor is in uniprocessor mode or not online, 
ar it is the main processor. 

if a VARY ONLINE PROCESSOR nn command was entered, this response 
indicates that the system is not generated for AP mode, the HP function 
is not installed, or the system is already in AP mode. 

PROCESSOR nn ONLINE 

indicates that the specified processor is now online and operational. 

PROCESSOR nn OFFLINE 

indicates that the specified processor is now offline and not 
operational. 
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WARNING 



Privilege Classes: A or B 



Use the WARNING command to transmit high-priority messages to a 
specified user or to all users. The WARNING does not wait for input 
operations at the terminal to complete, but breaks in on the line 
currently being displayed and sends the message immediately (unless the 
SET WNG OFF command was previously issued for the virtual machine) . The 
format of the WARNING command is: 



1 

I Warning 


I ( userid ) 


msgtext 


■ 
1 


I WNG 

1 1 


j < OPerator > 
1 ( ALL ) 




1 
1 


L 






j 



wh ere : 
userid 



is the identification of the user who is to receive the 
message. 



OPERATOR sends the message to the primary system operator regardless of 
his userid. 

ALL allows the system operator to broadcast the message to all 
users receiving warning messages. 

mscrtext is the text of the messacre to be sent. 



Re sp onses 

hh:mm:ss 

WNG FROM userid: msgtext 

is the response to the users who are to receive the warning message. 
The hh:mm:ss represents the time in hours, minutes, and seconds when the 
message was sent to the user. 

No te : WARNING commands ring the alarm, if the ALARM feature is 
installed, and put the screen in a HOLD status (for 3270) . When this 
occurs, press the CANCEL key to put the screen in a RUNNING status. 
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Section 4. VM/370 Service Programs 



Controlling the 3704/3705 Communications Control 
Program 

Operational control of the 3704/3705 Communications Controller 
(hereinafter referred to as 3705) resides with the system operator via 
the NETWORK command. In addition, the behavior of the 3705 device is, 
for a large part, dependent upon the communications control program with 
which it was loaded- The communication control programs are created, 
assembled, or modified by a set of CHS commands specifically designed 
for this purpose. These commands are: 

ASH3705 

GEN3705 

LKED 

SAVENCP 

ZAP 

The cited commands, described in greater detail in the VM/370 System 
Programmer* s Guide, are the system programmer's responsibility. The 
3705 NETWORK and HCPD0MP commands, however, are the responsibility of 
the YM/370 system operator and are described elsewhere in this 
publication. 

The 3704/3705 Dynamic Trace Facility is supported for virtual machine 
operation. However, if the 3704/3705 in emulator mode is not dedicated 
to the user invoking the trace, the user is required to have in his 
directory a privilege class other than (or in addition to) G. 



Using CMS To Alter VM/370 Files 



j The VM/370 system operator is usually assigned a virtual machine with a 

I large DASD storage allotment. This DASD storage can be assigned to 

I other users as a temporary work area or for short-term DASD storage. In 

I addition, the operator* s virtual machine can record system statistical 

I data, or create and maintain directory files and other system files. 

I For whatever reason the operator uses the system, it is probable that 

I some files will need to be modified at some time. One of the easiest 

I ways to modify such system files is to use the CHS Editor (EDIT) 

I facilities. 

I The CMS EDIT facilities provide ways to create and modify all types 

| of CMS files. For a complete description of the CHS EDIT facilities and 

| commands, see the TH/370 CMS Oser^s Guide and the VH/370 CHS Command and 

| Macro Reference. 



| OTHER CMS COHHANDS 



I There may be occasions, caused by user demands, when other facilities of 

j CHS may be invoked. For example, to create punched output of a file for 

I use by another system, or to create a history file. The commands likely 

| to be needed by the system operator are the following: 
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CHSBATCH 


LISTFILE 


SET 


COMPARE 


MOVEFILE 


STATE 


COPYFILE 


PRINT 


TAPE 


ERASE 


PUNCH 


TAPPDS 


FORMAT 


QUERY 


TYPE 


LISTDS 


READCARD 


UPDATE 



A complete description of these and other commands and their usage is 
contained in the VH/370 CMS User's Guide and the VM^370 CMS Command and 
Macro Reference. 

DASD Dump Restore (DDR) Service Program and 
How To Use It 

Use the DASD Dump Restore (DDR) program to dump, restore, copy, or print 
?M/370 user minidisks. The DDR program may run as a standalone program, 
or under CMS via the DDR command. 

The DDR program has five functions: 

1. Dumps part or all of the data from a DASD device to tape. 

2. Transfers data from tapes created by the DDR dump function to a 
direct access device. The direct access device must be of the same 
type as that which originally contained the data. 

3. Copies data from one device to another of the same type. Data may 
be reordered, by cylinder, when copied from disk to disk. In order 
to copy one tape to another, the original tape must have been 
created by the DDR DUMP function. 

4. Prints selected parts of DASD and tape records in hexadecimal anl 
EBCDIC on the virtual printer. 

5. Displays selected parts of DASD and tape records in hexadecimal and 
EBCDIC on the terminal. 

To generate the YM/370 starter system from the distribution tape, tin 
standalone RESTORE function must be used. 



INVOKING DDR UNDER CHS 

The format of the DDR command is; 











i 




DDR 


i 

I [fn 

I 

I 


ft \tm\ ] 
I* I 

L J 


i 
1 
1 
1 


L 








J 



where: 



r t 

fn ft |f ml is the identification of the file containing the control 

|* j statements for the DDR program. If no file 

i J identification is provided, the DDR program attempts to 

obtain control statements from the console. The filemode 

defaults to an asterisk (*) if a value is not provided. 
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Note: If you use the CHS DDE command, CHS ignores the SYSPRINT control 
statement and directs the output to the CHS printer 00E- 

INVOKING DDR AS A STANDALONE PROGRAH 

To use DDR as a standalone program, the operator should IPL it from a 
real or virtual IPL device as he would any other standalone program. 
Then indicate where the DDR program is to obtain its control statements 
by responding to prompting messages at the console. 

I Notes ; 

I 1. Be aware that DDR when run as a standalone program has only the 
most elementary error recovery support. However, when DDR is 
invoked in CHS, in a virtual machine environment, the I/O operation 
is performed by CP which has better error recovery facilities. 

I 2. When running standalone, DDR will search for a console at address 

I 009 or 01F. If these consoles are not operational, the program 

I will enter a wait state, waiting for an interrupt to identify the 

| console. If any nonconsole— type device is physically connected to 

| address 009 or 01 F, it must be made nonoperational or the results 

I will be unpredictable. 

I 3. The standalone DDR utility will not support cylinder faults for HSS 
I virtual volumes when performing the DUHP or COPY functions. 

DDR CONTROL STATEHENTS 

DDR control statements describe the intended processing and the needed 
I/O devices. I/O definition statements must be specified first. 

All control statements may be entered from either the console or the 
card reader. Only columns 1 to 71 are inspected by the program. All 
data after the last operand in a statement is ignored. An output tape 
must have the DASD cylinder header records in ascending seguences; 
therefore, the extents must be entered in seguence by cylinder. Only 
one type of function — dump, restore, or copy — may be performed in 
one execution, but up to 20 statements describing cylinder extents may 
be entered. The function statements are delimited by (preceded by) an 
INPUT and OUTPUT statement. If additional functions are to be 
performed, the seguence of control cards must be repeated. If you do 
not use INPUT or OUTPUT control statements to separate the functions you 
specify when the input is read from a card reader or CHS file, an error 
message (DHKDDR702E) is displayed. However, the remainder of the input 
stream will be checked for proper syntax, but no further DDR operations 
will be performed. Only those I/O devices defined by the INPUT 
statement and the OUTPUT statement must be redefined in subseguent 
steps. The SYSPRINT I/O definition remains the same. 

To return to CHS, enter a null line (carriage return) in response to 
the prompting message (ENTER:). To return directly to CP, key in #CP. 

The PRINT and TYPE statements work differently from other DDR control 
statements in that they operate on only one data extent at a time and it 
is not necessary to respecify the INPUT statement ahead of each PRINT or 
TYPE statement. If the input is from a tape created by the dump 
function, the tape must be positioned at the header record for each 
step. The PRINT and TYPE statements have an implied output of either 
the console (TYPE) or system printer (PRINT) , so no OUTPUT statement is 
reguired. 
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I/O DEFINITION STATEMENTS 

The I/O definition statements describe the tape, DASD, and printer 
devices used while executing the DASD Dump Restore program. 

INPOT/OUTPDT Control Statement 



An INPUT or OUTPUT statement describes each 
The format of the INPUT/OUTPUT statement is: 



tape and DASD unit used. 




[ (options. ..) ] 



r i 

cuu type |volserf 

| alt ape | 

L J 

Options: 



ISKip nn | IHOde 6250 | |REWind| 

I SKip | IHOde 1600 | I UN load \ 

«- -> IHOde 800 | |LEave | 

L J L J 



where : 

INPUT 

OUTPUT 



cuu 
type 



volser 



indicates that the device described is an input device. 

indicates that the device described is an output device. 

Note: If the output device is a DASD device and DDE is running 
under CHS, the device is released using the CMS RELEASE 
command function and DDR processing continues. 

is the unit address of the device. 

is the device type (2314, 2319, 3330, 3330-11, 3340-35, 
3340-70, 3350, 2305-1, 2305-2, 2400, 2420, or 3420) (no 
7-track support for any tape devices) . Specify a 3410 as a 
3420. Specify a 3340-70F as a 3340-70, and a 3333 as a 3330. 
Specify a 3350 that is in 3330-1 or 3330-11 compatibility mode 
as a 3330 or 3330-11. Specify a 3344 as a 3340-70, and 
specify 3350 for a 3350 operating in native mode (as opposed 
to compatibility mode) . 

Note: The DASD Dump Restore (DDR) program, executing in a 
virtual machine, uses I/O DIAGNOSE 20 to perform I/O 
operations on tape and DASD devices. DDR under CHS reguires 
that the device type entered agree with the device type of the 
real device as recognized by VH/370. If there is a conflict 
with device types, the following message is issued: 

DMKDDE708E INVALID OPTION 

However, if DDR executes standalone in a virtual machine, DDR 
uses DIAGNOSE 20 to perform the I/O operation if the device 
types agree. If the device types do not agree, error message 
DHKDDR708E is issued. 

is the volume serial number of a DASD device. If the keyword 
"SCRATCH" is specified instead of the volume serial number, no 
label verification is performed. 
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altape is the address of an alternate tape drive. 

Note; If multiple reels of tape are required and "altape" is 
not specified, DDR types the following at the end of the reel: 

END OF VOLOHE CYL XXX HD XXX, HOOHT NEIT TAPE 

After the new tape is mounted, DDB continues automatically. 

Options : 

SKIP nn forward spaces nn files on the tape, nn is any number 
up to 255. The SKIP option is reset to zero after the 
tape has been positioned. 



r t 

HODE |6250| causes all output tapes that are opened for the first 

I 1600J time and at the load point to be written or read in 

j 800| the specified density, all subsequent tapes mounted 

*■ J are also set to the specified density. If no mode 

option is specified, then no mode set is performed and 

the density setting remains as it previously was. 



REWIND 



ONLOAD 



LEAVE 



rewinds the tape at the end of a function. 

rewinds and unloads the tape at the end of a function. 



leaves the tape positioned at the 
the end of a function. 



end of the file at 



Notes: 



When the wrong input tape is mounted, the message DHKDDS709E is 
displayed and the tape will rewind and unload regardless of options 
REWIND, ONLOAD, or LEAVE being specified. 

If DDR is executed from CHS, failure to attach the tape drive or 
the disk device (or both) to your virtual machine prior to invoking 
the input/output statement causes the following response to be 
displayed: 

INVALID INPOT OR OOTPOT DEFINITION 



SISPRINT Control Statement 



Ose the SISPRINT control statement (in the 
machine only) to describe the printer that is 
specified by the PRINT statement. It also c 
cylinder extents from the DOHP, RESTORE, or 
SISPRINT statement is not provided, the printer 
00E. CMS ignores the SISPRINT statement whe 
command under CHS, and CHS always directs the ou 
of the SISPRINT control statement is: 



standalone DDR virtual 
to print data extents 
an print a map of the 
COPI statement. If the 
assignment defaults to 
n you invoke DDR as a 
tput to 00E. The format 



I SIsprint | cuu 

1 



where: 
cuu 



specifies the unit address of the device. 
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Function Statements 



The function statements tell the DDR program what action to perform. 
The function commands also describe the extents to be dumped, copied, or 
restored. The format of the DOMP/COPY/RESTORE control statement is: 



1 


r 


I DOmp 


|cyl1 [To] 


1 copy 


ICPvol 


| REstore 


| ALL 


1 


INOcleus 


1 


L 



[cyl2 [Reorder] [To] [cyl3]] | 



where: 



DOMP 



COPY 



RESTORE 



requests the program to move data from a direct access volume 
onto a magnetic tape or tapes. The data is moved cylinder by 
cylinder. Any number of cylinders may be moved. The format 
of the resulting tape is: 



Record 1; a volume header 
describing the volumes. 



record, consisting of data 



Reco rd 2: a track header record, consisting of a list of count 
fields to restore the track, and the number of data records 
written on tape. After the last count field the record 
contains key and data records to fill the 4K buffer. 

Record 3: track data records, consisting of key and data 
records packed into 4K blocks, with the last record truncated. 

Record 4: either the end— of-volume (E07) or end-of-job (EOJ) 
trailer label. The end— of-volume label contains the same 
information as the next volume header record, except that the 
ID field contains EOV. The end— of-job trailer label contains 
the same information as record 1 except that the cylinder 
number field contains the disk address of the last record on 
tape and the i ID field contains EOJ. 

requests the program to copy data from one device to another 
device of the same or equivalent type. Data may be recorded 
on a cylinder basis from input device to output device. A 
tape-to-tape copy can be accomplished only with data dumped by 
this program. 

requests the program to return data that has been dumped by 
this program. Data can be restored only to a DASD volume of 
the same or equivalent device type from which it was dumped. 
It is possible to dump from a real disk and restore to a 
minidisk as long as the device types are the same. 



cyil [TO] [cyl2 [REORDER] [TO] [cyl3]] 

Only those cylinders specified are moved, s 
first track of the first cylinder (cylT) , an 
last track of the second cylinder (cyl2) . Th 
causes the output to be reordered, that is, m 
cylinders, starting at the specified cylinder 
starting cylinder (cyll) if cyl3 is not 
REORDER operand must not be specified unless 
are defined for the operation; the starting 
ending cylinders (cyll and cyl2) must be spec 
if the input device cylinder extents excee 



wCLj- bxuvj ■ j.i.u uu^ 

d ending with the 

e REORDER operand 

oved to different 

(cyl3) or at the 

specified. The 

specified limits 

and, if required, 

ified. Note that 

d the number of 
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cylinders specified on the output device, an error message 
results. 



CPVOL 



Caution: The REORDER operand is intended to be used to aove 
minidisks to new locations; it is not intended for re-locating 
non— minidisk cylinders. To understand the difference, 
consider a 10 cylinder minidisk. Its cylinders are numbered 
0—9 and the count fields of its records refer to cylinders 
0—9. Furthermore, if the minidisk contains location— dependent 
data, then references to cylinders 0—9 will be hidden within 
that data. When REORDER is used to move the minidisk to a new 
real location, the minidisk cylinders are nevertheless still 
regarded as being cylinders 0—9 and there is no need to change 
the cylinder numbers in the count field of the records. On 
the other hand, when moving non— minidisk cylinders, one would 
generally want the count fields of the moved records to 
reflect the new cylinder addresses; but REORDER keeps the 
original cylinder numbers in the count fields. 

specifies that cylinder and all active directory and 
permanent disk space are to be copied, dumped, or restored. 
This indicates that both source and target disk must be in CP 
format, that is, the CP Format/Allocate program must have 
formatted them. 



ALL 



NUCLEUS 



specifies that the operation is to be performed on all 
cylinders, except alternate track cylinders on some devices. 
(See "Restrictions" below.) 

Note: The occurrence of message DHKDDR705E (issued upon 
completion of the copy restore or dump operation) indicates 
that an attempt was made to copy restore or dump the contents 
of cylinders beyond the extents of the designated minidisk. 

specifies that record 2 on cylinder 0, track and the nucleus 
cylinders are dumped, copied, or restored. 



Rest r i ctions : 

• Each track processed by this utility must have a valid home address 
on it containing the real cylinder and track location. Even when 
restoring and copying data to a track it must have a pre-existing 
home address on it. 

• Each track on an input DASD device must have a valid record zero on 
it, with no more than eight bytes in the key and data fields of the 
record. Each track on an output DASD device must also have a valid 
record zero on it unless that device is 2314, 2319, 2305-1, or 
2305-2. 

• Flagged tracks are treated just as any other track for all 2314, 
2319, and 2305 devices. That is, no attempt is made to substitute 
the alternate track data when a defective primary track is read. In 
addition, tracks are not inspected to determine whether they were 
previously flagged when written. Therefore, volumes containing 
flagged tracks should be restored to the same cylinders of the volume 
from which they were dumped. The message DHKEDR715E occurs each tiie 
a defective track is dumped, copied or restored, and the operation 
continues. When ALL is specified for these device types, both the 
primary cylinders and the high— order cylinders normally reserved for 
alternate tracks are dumped,, copied, or restored. 
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• Flagged tracks on 3330, 3340, and 3350 devices are handled so that 
data is transferred to or from the assigned alternate track in place 
of the defective track. (For 3330 and 3350 this is accomplished 
automatically by the hardware of the control unit while for the 3340 
and 3344 it is accomplished through software.) The tape created by 
dumping one of these types of DASD devices will appear as if it had 
been dumped from a defect— free device and the tape can be restored to 
any device of the same type, even though that device might not have 
the same tracks flagged defective as the original device had. (The 
COPY function works this way also.) If a track is flagged as 
defective, but has no alternate assigned, a warning message is issued 
and the only data transferred is the home address record and record 
zero. When ALL is specified for these device types, only the primary 
cylinders are processed; the cylinders reserved for alternate tracks 
are not processed except that an assigned alternate track is 
processed whenever the corresponding defective track is processed. 
However, by specifying the cylinder range explicitly (cyll to cyl2 
format) , all cylinders, including cylinders in the alternate track 
area, can be dumped or copied from. But these same cylinders cannot 
be restored to or copied to explicitly. It is intended that 
explicitly dumped cylinders in the alternate track area will be 
restored to another area via the REORDER operand. The only reason 
the explicit dumping and copying of cylinders from the alternate 
track area is allowed at all is to facilitate conversion of 3340 and 
3344 disks that were written using early releases of VH/370. Prior 
to Release 5 PLC 6, it was sometimes the practice to treat the 
alternate track area as if it was just another primary cylinder and 
to allow minidisks to be located there. But this is no longer 
permitted. 

Example: 

IHPUT 191 3330 SYSRES 

OUTPUT 180 2400 181 (MODE 800 

SYSPRINT OOF 

DUMP CPYOL 

INPUT 130 3330 MIHI01 

DUMP 1 TO 50 REORDER 51 

60 70 101 

This example sets the density to 800 bpi, then dumps all pertinent 
data from the volume labeled SYSRES onto the tape that is mounted on 
unit 180. If the program runs out of space on the first tape, it 
continues dumping onto the alternate device (181) . A map of the dumped 
cylinders is printed on unit OOF while the program is dumping. When the 
first function is complete, the volume labeled BIHI01 is dumped onto a 
new tape. Its cylinder header records are labeled 51 to 100. A map of 
the dumped cylinders is printed on unit 00F. Next, cylinders 60 to 70 
are dumped and labeled 101 to 111. This extent is added to the cylinder 
map on unit OOF. When the DDR processing is complete, the tapes are 
unloaded and the program stops. 
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If cylinder extents are being defined from the console, the user need 
only enter DUMP, COPY or RESTORE on the command line. The following is 
displayed: 

ENTER CYLINDER EXTENTS 
ENTER: 

For any extent after the first extent, the message 

ENTER NEXT EXTENT OR NOLL LINE 
ENTER: 

is displayed. 

The user may then enter additional extents to be dumped, restored, or 
copied. A null line causes the job step to start. 

Notes: 

1. When a cylinder map is printed on the virtual printer (OOF as in 
the previous example) a heading precedes the map information. 
Module DMKDDR controls the disk, time and zone printed in the 
heading. Your installation must apply a local modification to 
DMKDDR to ensure that local time, rather than GMT (Greenwich 
Meridian Time} , is printed in the heading. 

2. Attempts to restore cylinders beyond the capacity that had been 
recorded on the tape produces a successful EOJ, but the printout 
only indicates the last cylinder found on the tape. 



PRINT/TYPE Function Statement 

Use the PRINT and TYPE function statement to print or type (display) a 
hexadecimal and EBCDIC translation of each record specified. The first 
of a group of PRINT or TYPE statements must be preceded by an INPUT 
statement defining either a direct access device or a tape. The output 
is directed to the system console for the TYPE function, or to the 
SYSPRINT device for the PRINT function. (This does not cause 
redefinition of the output unit definition.) PRINT and TYPE may be used 
to display the contents of any track including those in the alternate 
track cylinders. For 3330, 3340, and 3350 devices, the following is 
displayed when alternate tracks are involved: 

• When displaying a defective track that has a properly assigned 
alternate, the home address record displayed is taken from the 
defective track while record zero and all other records are taken 
from the alternate. The "defective" flag, visable in the displayed 
home address, is the only hint that this is not a normal track. 

• When displaying a flagged defective track which does not have a 
proper alternate, only the home address record and record zero are 

displayed, and they are both taken from the defective track. 

• When displaying an alternate track explicitly, all data displayed is 
from that track. 



Section 4. VM/370 Service Programs 165 



The format of the PRIHT/TYPE control statement is: 



I PRint | cyll [hh1 [rr1]] [To cyl2 [hh2 [rr2 ]]] [ (options. ..[) ]] 

I TYpe | 

I | options; 

I I [Hex] [Graphic] [Count] 



l_ 



where: 

cyll is the starting cylinder. 

hh1 is the starting track. If present, it Bust follow the cyll 
operand. The default is track zero. 

rr1 is the starting record. If present, it must follow the hh1 
operand. The default is home address and record zero. 

TO cyl2 is the ending cylinder. If more than one cylinder is to be 
printed or typed, "TO cyl2" must be specified. 

hh2 is the ending track. If present, it must follow the cyl2 
operand. The default is the last track on the ending 
cylinder. 

rr2 is the record ID of the last record to print. The default is 
the last record on the ending track. 

Options : 

BEX prints or displays a hexadecimal representation of each 
record specified. 

GRAPHIC prints or displays an EBCDIC translation of each record 
specified. 

COURT prints or displays only the count field for each record 
specified. 

Ds aqe 

If the TYPE statement follows the occurrence of error message DHKDDR705E 
and specifies the same cylinder, track, and record extents indicated in 
the error message, the contents of the printed record must be 
interpreted in the context of the I/O error information given in the 
initial message. 



Exampl es 
PRINT TO 3 

Prints all of the records from cylinders 0- 1- 2- and 3 
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PRINT 1 3 

Prints only one record, froi cylinder 0, track 1, record 3. 

PRINT 1 10 3 TO 1 15 a 

Prints all records starting with cylinder 1, track 10, record 3, and 
ending with cylinder 1, track 15, record 4. 

The example in Figure 6 shows the information displayed at the 
console (TYPE function) or system printer (PRINT function) by the DDR 
program. The listing is annotated to describe some of the data fields. 



Responses 



ENTER CYLINDER EXTENTS 
ENTER: 

This message is received only if you are entering input from your 
terminal. 

END OF VOLUME CYL XXX HD XX, MOUNT NEXT TAPE 

DDR continues processing, after the mounting of the next tape reel. 
RESTORING volser 

where; 

volser is the volume serial number of the disk dumped. The 
RESTORE operation has begun. 

COPYING volser 

where: 

volser is the volume serial number described by the input unit. 
The COPY operation has begun. 

DUMPING volser 

where: 

volser is the volume serial number described by the input unit. 
The dumping operation has begun. 

PRINTING volser 

w here : 

volser is the volume serial number described by the input unit. 
The PRINT operation has begun. 

END OF DUMP 

The DUMP operation has ended. 
END OF RESTORE 

The RESTORE operation has ended. 
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END OF COPY 

The COPY operation has ended. 
END OF PRINT 

The PRINT operation has ended. 
END OF JOB 

All specified operations have completed. 

ENTER: 

Prompts input from the terminal. A null line (Press the Enter key 
or equivalent) causes control to return to CHS, if the virtual 
machine is in the CHS environment. 

In addition to the above responses, other informational messages 
that call for a response by the operator to continue, terminate, or 
reinitiate the current operation are described in VH^370 System 
Hes saq es . 

For return codes associated with DDR messages, see the VH/370 CHS 
Command and Hacro Reference. 
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Record 1 




1st Half of - 
Record 2 



Home Address 
Record 

2nd Half of 
Record 2 



Record 3 



Record 4 " 



CYL 019 HD 00 HOME ADDRESS 0000130000 IRECORD ZERO 0013000000 



Cylinder and head 
identification for 
Record 



DOOOJF 



Home Address of track 
in hexadecimal format 



Record ID from the 
count field 




If the data length field is not zero I 

A heading is printed containing the I 

data length from the count field first in I 
decimal, then in hexadecimal 
The data is then printed in hexadecimal 
with graphic interpretation to the right 
(not shown here). , I 



04096 1000 DATA LENGTH 



00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 



-♦-CYL 019. HD 00 REC 002 CO UNT 0013000002 00 |09A8| Note: Data Length field repeated 

. r^ ■ ' in heading. 

02472 |09A8| DATA LENGTH 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 

ABOVE RECORD WRITTEN USING RECORD OVERFLOW ^ 

1 

Iw This statement indicates that this portion • 
of Record 2 was written using the Write I 

I Special Count, Key, and Data command. The 

remainder of Record 2 is found on the next I 
track as the first record after Record 0. 

L / I 

».. . CY[_ nig un ni ljqmc ADDRESS 0000130001 RECORD ZERO 00130Q0100 00 0008 00000000 00000000 

•CYL 019 HD 01 REC 002 COUNT 0013000102 00 0658-* ' 

01624 0658 DATA LENGTH 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 

, Q If the key length field is not zero 

• A heading is printed containing the key length I 

first in decimal, then in hexadecimal. 
I / • The key is then printed in hexadecimal with I 

' ' graphic interpretation to the right (not shown here). 

CYL 019 HD 01 REC 003 COUNT 0013000103 80 0F80 

00128 0080 KEY LENGTH-* 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE ... 

03968 0F80 DATA LENGTH 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 

• CYL 019 HD 01 REC 004 COUNT 0013000104 00 0000 ™ 

END OF FILE RECORD- 

-!® I 

| Whenever the data length field is zero I 

• an end-of-file prints next. I 




Figure 6- Annotated Saiple of Output from the TYPE and PRINT Functions 
of the DDR Program 
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I Genimage and Imagelib Service Routines 



VM/370 uses the OS utility program IEBIMAGE to enable the installation 
to change the character arrangement tables, forms control buffer, copy 
modification and graphic tables that are available to the users. The 
CMS system communicates with this utility through the use of two CBS 
commands: 

GEHIMAGE presents the input control file to the IEBIMAGE utility 
program. GENIMAGE creates the text files on a CMS disk. Text 
files are the images used by the 3800 printer. The text files 
represent new images or replacements to existing images. The 
format of the GENIMAGE control statement is: 



GENIMAGE 



r i 
Ifn I 
I SYS IN | 

L J 



r n 

Ift | 

L J 



r t 

Ifml 
I* I 

L J 



Isfn | 
| SY SPRINT | 



r n r t 

|sft | |sfm| 

| LISTING | |A1 | 

L J L J 



where: 
fn 

ft 

fi 

sfn 
sft 
sfm 



specifies the filename of the input control file. The name 
may be up to eight alphameric characters in length. If not 
specified, the default filename is SYSIN. 

specifies the filetype of the control file. Filetype may be 
up to eight alphameric characters in length. If not 
specified, the default filetype is FILE. 



specifies the filemode of the control file 
up to two alphameric characters in length, 
the default filemode is *. 



Filemode may be 
If not specified. 



specifies the filename into which the messages listing is 
placed. If not specified, the default file name is SYSPRINT. 

specifies the filetype for the messages listing. If not 
specified, the default file type is LISTING. 

specifies the filemode for the messages listing. If not 
specified, the default file mode is A1. 



IMAGELIB reads the control file containing the list of text images 
The files are then loaded into the specified named system 
The format of the IMAGELIB control statement is: 



r .._ 
I 


| 




i 

1 


1 

i 
i 


1 

IMAGELIB i 
i 


u«m«dt>_y a 


f 

i 


l 

L 


I 




I 
j 



where: 

namedsys specifies the named system that is being created or replaced 
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Responses : 



The programs generate Messages that indicate successful completion or 
errors. Completion messages and codes are returned to the user in the 
file indicated by the sfn and sft operands of the GENIMAGE control 
j statement. 

Note : 

Further discussion of the IEBIHAGE utility program is contained in the 
OS/VS IBM 3 800 P rinting Subsystem Programmer* s Guide . 



Formatting Volumes — Genera! information 



Disk Initialization 

Disk initialization and alternate track assignment should be performed 
by the IBCDASDI utility program on all direct access volumes used in a 
VH/370 installation, but with the following exceptions: 

• On 2314 and 2319 disks only if there are minidisks, then the 
individual minidisks should be initialized, rather than initializing 
the real disk. 

• The 2305 drum should not have alternate tracks assigned. Instead, 
defective tracks should be rewired to alternate tracks by the CE. 
The rewiring makes the defective track transparent to all 
programming. (CP itself has no recovery procedures for "software 
assigned 11 alternate tracks on the 2305; however, an operating system 
running in one of its virtual machines might make use of them.) 



Disk Formattin g 

All direct access volumes used by the VH/370 system (for paging, 
spooling, system residence, directory, or temporary disk allocation) 
must be properly labeled, formatted, and allocated. The CP 
Format /Allocate service program (DHKFHT module) prepares disks for use 
by CP* A CHS Format program is also available and must be used to 
format CHS and RSCS disks. 

All direct access volumes (including both real disks and minidisks) 
to be used by VSAH under CHS, OS, or DOS, must be formatted by the 
IBCDASDI utility. 

If certain information in the OS Format 4 label on track cylinder 
is destroyed, no additional alternate tracks can be assigned by IBCDASDI 
until the volume is reformatted by IBCDASDI. When either IBCDASDI or 
the CP Format/Allocate program (DHKFHT) is used to format a volume, this 
information in the OS Format 4 label is preserved. But, when the CHS 
Format Program formats the volume (or when it formats a minidisk whose 
origin is cylinder of the volume) the OS Format 4 label is destroyed 
and no further alternate tracks can be assigned until IBCDASDI is used 
to reformat the volume. 
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Format/Allocate Services Program (DMKFMT) 

The Format/Allocate service program formats, allocates, and labels 
direct access volumes for paging, spooling and CP file residence. This 
service program is executed as part of CP system generation procedures 
and may also be executed as a stand-alone program to: 

• Format direct access volumes for CP use 

• Allocate specific disk areas to particular functions or to CP use 

• Write six-charactef volume serial number labels 

Note: The Format/Allocate program should be used with care since it 
destroys existing data (if any) . Also, user minidisks and temporary 
minidisks must not begin on real cylinder zero of CP-owned volumes, 
because information critical to CP is stored in that cylinder. 

An object deck version of the CP Format/Allocate service program is a 
standalone program and can be loaded from a virtual or real card reader 
into a virtual or a real machine. (If run in a virtual machine, the 
virtual machine must have write access to the volume being formatted.) 
The program accepts control statements from the operators system 
console (commands) or from the IPL device (card reader) . 

Note: Messages DMKFMT736E and DMKFMT7 35E may be issued if an available 
path to the device cannot be found after an appropriate number of 
retries. High activity may cause this situation. 



Cylinders used by CP for paging, spooling, and so on, must 
Preformatted with fixed length unblocked records of 4096 bytes. 



be 



Device capacity when formatted for CP use is: 



2314/2319 32 records/cylinder 

333 57 records/cylinder 

2305 24 records/cylinder 

3340 24 records/cylinder 

3350 120 records/cylinder 



(8 records/5 tracks) 

(3 records/track) 

(3 records/track) 

(2 records/track) 

(4 records/ track) 



The format operation writes 4096-byte blocks on all cylinders being 
formatted. The service program does write-checking to verify that parts 
of the track are net defective. A count is maintained of pages with 
read check errors detected during the format operation. At the 
completion of the format operation, the count of the pages with read 
check errors is printed. 
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Format for All Cylinders Except Cylinder Zero 

For example, the 3330 track format for all formatted cylinders except 
cylinder is shown in Figure 7, 



Track 0: 



BO 



R1 



62 



F3 



I I 



I I 



I I 
i I 



8 


bytes 




4096 bytes 


4096 bytes 


4096 bytes 


Track 1 * 


to Track 


18 


: 








R0 




R1 


R2 


R3 


r 

I 


1 


t 1 


r i 
1 1 


i 

1 


I 

L — - 


1 
j 




1 1 

4 3 


1 1 


1 
^ 


8 


bytes 




4096 bytes 


4096 bytes 


4096 bytes 



Figure 7. Format of 3330 Cylinders for Use by CP 



Fo rma t for Cylinder Zero 



All volumes containing space for CP use (paging, spooling, and so on) 
must have a properly formatted cylinder 0. The only service program 
that can do this is the Format/Allocate program (DMKFHT) . 

Cylinder is formatted like other cylinders except that the space 
associated with the first three 4096-byte blocks is reserved for system 
use. This area is then formatted as illustrated in Figure 8. 



Track 



R0 



R1 

i 1 

I IPL | 
I rec | 
i 1 

24 



R2 



DMKCKP 
Module 



4096 



KEY 



R3 



i 1 

t VI I 

I 0| VOLID | 

ir. i t 

in i 

i 1 

4 80 



R4 



KEY 



R! 



KEY 



R6 



i 1 i 1 i 1 r 

| Allocation | I I Format | | | Format | I 

I Byte map I I I 4 DSCB | I I 5 DSCB | I 

I 1 | 1 | 1 L 



FR 



//- 



1024 44 96 44 96 
Track 1 to Track 18 are the same as the nonzero cylinders. 

I ; 

Figure 8. 3330, 3340, or 3350 Cylinder Format 
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The contents of each record in cylinder track are as follows: 

BO Nothing. 

R1 IPL record — Puts the system into wait state if storage volume is 
loaded before CP nucleus is built. 

B2 Checkpoint record — Used by CP to save and retrieve information 
for a warm start. 

B3 Volume label — Same as OS V0L1 label. On CP system residence 
volume, area in data record marks the beginning of the system 
directory. A label is automatically written when cylinder is 
formatted. The owner field of the label record contains "VH/370" 
if there is allocation data present in B4. 

B4 Allocation Byte Hap — Each byte identifies a cylinder and 
specifies its usage (paging, spooling, directory, and so on) . This 
map is filled in by the ALLOCATE function of the DHKFHT service 
program. 

B5 Format 4 OS DSCB type label — For compatibility with OS. Also, 
the IBCDASDI program uses this label to keep a record of how many 
alternate tracks remain available for assignment on this disk. The 
Format/Allocate program will preserve this information by first 
reading it from any existing Format 4 label, and then writing it 
back in the new label. 

B6 Format 5 OS DSCB type label — For compatibility with OS. Label 
indicates to OS that no space is available en this volume. 

FB Is one or more filler records. 

Format/Allocate program control statements may be supplied in card 
form via a card reader, or may be entered at the system console. All 
error messages regarding improper specification of control statements 
are displayed at the console. 



FOBMAT/ALLOCATE PROGBAM CABD INPUT 

Punch control statements for card input start in column 1, and each 
field is separated from the adjacent field by a comma. Two commas in a 
row cause the insertion of a default value. Three commas in a row cause 
the insertion of two default values. 
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Note: The only default values permitted are those that define the 
starting and ending cylinders. The defaults are the first and last 
cylinders of the volume, respectively. 

Comments must be preceded by at least three blanks. 

The control card entries for the Format/Allocate program must be in 
the following order: 

• Format function: 

FORMAT, devadr, devtype, volser, startcyladr, endcyladr 

• Allocate function: 

ALLOCATE, devadr, devtype, volser 
TEMP,startcyladr,endcyladr 
PERM, startcyladr , endcyladr 
TDSK, startcyladr , endcyladr 
DRCT, startcyladr, endcyladr 
END 

• Label functions: 

FORMAT, devadr, devtype, volser, LABEL 

FORMAT, ALLOCATE, and LABEL are Format/Allocate program control words 
and may be abbreviated to one letter. 



FORMAT Control Statement 

The format of the FORMAT control statement is: 



i — : 1 

I FORMAT, devadr, devtype, volser, startcyladr, endcyladr | 

i 1 

where: 

devadr is a three-digit hexadecimal number that identifies the 
address of the device that the Format/Allocate program is 
to act upon. Valid device addresses under CHS are X'OOI* 
to X'SFF* for ECMODE OFF and X*001» to X'FFF* for ECHODE 
ON. 

devtype is a four— to— seven character field that defines an approved 
device for the Format/Allocate program. Approved device 
types are 2314, 2319, 3330, 3330-11, 3340-35, 3340-70, 
3350, 2305-1, and 2305-2. Specify .3333 as 3330, and 
3340-70F or 3344 as 3340-70. Specify a 3350 device in 
3330-1 compatibility mode as a 3330, and a 3350 in 3330-11 
compatibility mode as a 3330-11. 

volser is a one-to-six character field that represents the volume 
serial number of the volume you are formatting. 

startcyladr is the starting cylinder address on the DASD on which the 
format function is to be performed. The start cylinder 
address is entered as decimal digits. 

endcyladr is the last cylinder address on the DASD on which the 
format function is to be performed,. The end cylinder 
address is entered as decimal digits. 
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Note; FORMAT is a control word and maybe abbreviated to F. 



ALLOCATE Control Statements 



The formats of the ALLOCATE control statements are; 



ALLOCATE, devadr, devtype, volser 
TEMP, startcyladr, endcyladr 
PERM, startcyladr, endcyladr 
TDSK, startcyladr , endcyladr 
DRCT, startcyladr, endcyladr 
END 



where; 
devadr 



devtype 



volser 
startcyladr 

endcyladr 

TEMP 
PERM 

TDSK 
DRCT 



ALLOCATE 
letter, A. 



is a three— digit hexadecimal number that identifies the 
address of the device that the Format/Allocate program is 
to act upon. Valid device addresses under CMS are X'001' 
to X'5FF« for ECMODE OFF and X'OOI 1 to X'FFF' for ECMODE 
ON. 

is a four-or— seven character field that defines an approved 
device for the Format/Allocate program. Approved device 
types are 2314, 2319, 3330, 3330-11, 3340-35, 3340-70, 
3350, 2305-1, and 2305-2. Specify a 3350 device in 3330-1 
compatibility mode as a 3330 and a 3350 in 3330-11 
compatibility mode as a 3330-11. Specify a 3333 as a 3330, 
and 3340-70F or 3344 as 3340-70. 

is a one— to-six character field that represents the volume 
serial number of the volume you are formatting. 

is the starting cylinder address on the DASD on which the 
format function is to be performed. The start cylinder 
address is entered as decimal digits. 

is the last cylinder address on the DASD on which the 
format function is to be performed. The end cylinder 
address is entered as decimal digits. 

indicates that the following operands identify temporary 
storage space reserved for spooling or paging activity. 

defines an area that can contain the logout area, the CP 
nucleus, and space that is not used by the system but is 
available for use by virtual machine users (for example, 
for user minidisks) . 

defines the pooled space available for virtual machine 
users after they have logged on the VM/370 system. 

indicates that the following cylinders are reserved for 
directory files. 

is a control word and may be abbreviated to its first 
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TEMP, PERM, TDSK, and DECT are all functions of ALLOCATE. These 
cards can follow the ALLOCATE control statement in any sequence. Each 
card in turn overlays the cylinder table, and any space not reallocated 
remains the same. If an ALLOCATE function overlays the previous 
cylinder allotment, then the previous cylinder space allotment is 
truncated to the beginning of the next cylinder allotment. For example: 

Disk Storage 

Alloc ation 

1st Entry TEMP 

2nd Entry PERM 

3rd Entry TDISK 

4th Entry DRCT 

5th Entry END 



First 


Last 


Cylinder 


Cylinder 


000 


20 2 


010 


050 


040 


050 


000 


004 



The result of this disk volume allocation is: 



Disk storage 


First 


Last 


Allocation 


Cylinder 
000 


Cylinder 


DRCT 


004 


TEMP 


005 


009 


PERM 


010 


039 


TDSK 


OUO 


050 


TEMP 


051 


20 2 



Once an ALLOCATE control statement is encountered, all cards 
following it until an END card is encountered are assumed to be part of 
a single allocation. The Format/Allocate service functions cannot be 
performed on another disk volume until the END card is encountered- Any 
area not allocated will default to "TEMP" space. (See Figure 10.) 
Note, however that if the allocation extent map does not cover the 
entire volume (as could be the case if the volume was copied from a 
smaller volume or minidisk) the remainder of the volume is allocated as 
PERM space. 

Note: Reallocation of a directory cylinder containing an active VM/370 
directory deallocates the directory to allow a new directory to be 
written on the same cylinder. After reallocation, the Directory program 
must be executed to reinitialize the directory pointer, if this is not 
done, when you initialize (via IPL) , your program will abend (ABEND 
CPI002) . 



LABEL Control Statement 

The format of the LABEL control statement is: 



I FORMAT, devadr,devtype,volser, LABEL 



where : 
devadr 



is a three-digit hexadecimal number that identifies the 
address of the device that the Format/Allocate program is 
to act upon. Valid device addresses under CMS are X'001» 
to X*5FF' for ECMODE OFF and X'001 1 to X«FFF« for ECMODE 
ON. 



devtype is a four-to-seven character field that defines an approved 
device for the Format/Allocate program. Approved device 
types are 2314, 2319, 3330, 33 30-11, 3340, 3340-35, 
3340-70, 3350, 2305-1, and 2305-2. Specify a 3350 device 
in 3330-1 compatibility mode as a 3330, and a 3350 in 
3330-11 compatibility mode as a 3330-11. Specify a 3333 as 
a 3330, and 3340-70F or 3344 as 3340-70. 
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volser is a one-to-six character field that represents the volume 

serial number. 

LABEL is a keyword designating the label function of the 

Format/Allocate program. 

Note: FORMAT and LABEL are control words and may be abbreviated to F and 
L, respectively. 



FORMAT: 

FORMAT, 232 , 3330 ,MYDISK, 000 ,006 
FORMAT, 232,3330, MYDISK, , , 
FORMAT, 232, 3330, MYDISK,, 00 
FORM AT, 232, 3330, MYDISK, 001,, 

ALLOCATE: 

ALLOC ATE, 232, 3330, MYDISK 

TEMP, 000, 050 

PERM, 055, 060 

TDSK,100,108 

DRCT,110,120 

END 

LA BEL *. 

F,232, 3330, MYDISK, label 



FORMAT/ALLOCATE CONSOLE INPUT 

The Format/Allocate program can be controlled by control statements 
entered into the real or virtual console instead of by a deck of cards 
containing control statements. If the program finds no control 
statements at the card reader, it issues a prompting message to the 
console. The proper response causes the prompting message for the next 
operand to appear until the Format, Allocate, or Label function is 
completely defined; then the Format/Allocate program is executed. 

After execution, the prompting begins again until all DASD allocation 
reguirements are fulfilled. 

The seguence for console typewriter processing of the Format/Allocate 
program (after making the operator's console ready), is as follows: 

1. Load the card reader with a loader, followed by the Format/Allocate 
deck. 

2. IPL the card reader. 

3. Respond to the first message displayed at the system console. 

4. Respond to other messages. 

Following are examples of Format/Allocate program execution under CP 
control. Figure 9 is an example of the label operation. Figure 10 is an 
example of the allocate operation, and Figure 11 is an example the 
allocate overlap operation. All responses are entered after the colon; 
after a function is complete, the program returns and issues again the 
'ENTER "FORMAT" OR "ALLOCATE":' statement. 
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VM/370 FORMAT/ALLOCATE PROGRAM VERSION 3-0 

ENTER "FORMAT" OR "ALLOCATE" :f 
FORMAT FUNCTION SELECTED 
ENTER DEVICE ADDRESS (CUU):131 
ENTER DEVICE TYPE: 2314 

ENTER START CYLINDER (XXX) OR "LABEL" :1 
ENTER DEVICE LABEL:cpdsk2 
i 

Figure 9. Using the Format Program Label Function 



ENTER "FORMAT" OR "ALLOCATE": a 

ALLOCATE FUNCTION SELECTED 

ENTER DEVICE ADDRESS (CUU):131 

ENTER DEVICE TYPE: 2314 

ENTER DEVICE LABEL: cpdsk2 

ENTER ALLOCATION DATA FOR VOLUME CPDSK2 

TYPE CYL CYL 



drct 000 001 

perm 004 008 

task 100 150 

end 

ALLOCATION RESULTS 

DRCT 000 001 

TEMP 002 003 

PERM 004 008 

TEMP 009 099 

TDSK 100 150 

TEMP 151 202 

DEVICE 131 VOLUME CPDSK2 ALLOCATION ENDED 



Figure 10. Using the Format Program Allocate Function 



ENTER "FORMAT" OR "ALLOCATE": a 

ALLOCATE FUNCTION SELECTED 

ENTER DEVICE ADDRESS (CUU):131 

ENTER DEVICE TYPE: 2314 

ENTER DEVICE LABEL: cpdsk2 

ENTER ALLOCATION DATA FOR VOLUME CPDSK2 

TYPE CYL CYL 



perm 004 004 

temp 000 010 

tdsk 000 010 

perm 010 202 

drct 000 004 

end 

ALLOCATION RESULTS 

DRCT 000 004 

TDSK 005 009 

PERM 010 202 

DEVICE 131 VOLUME CPDSK2 ALLOCATION ENDED 

Figure 11. Using the Format Program Allocate Overlap Function 
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Note that before the ALLOCATE function was invoked, cylinder was 
formatted and labeled CPDSK2. The area associated with the first three 
40 96— byte blocks on cylinder are not used for spooling but contain 
system information (page allocation map, label, and so on) . 

These CP-formatted volumes can be made usable by CP in one of two 
ways: 

1 * They may be attached to the system by the YK/370 operator. 

2. Their volume serial numbers may appear in the SYSOWN macro in the 
DHKSYS module. The CP system residence volume^ serial number must 
appear in the SYSOWN macro. 



IBCDASDI — General Information 

VM/370 uses the OS utility program IBCDASDI for disk initialization, for 
disk formatting, and for assigning an alternate track. The execution of 
IBCDASDI is performed from the virtual card reader and the technigue is 
described in "Invoking IBCDASDI" later in this section. 

DISK INITIALIZATION - Corresponds roughly to what is referred to as 
"initialization with surface analysis" or "non-quick DASDI". It is 
invoked by a DADEF statement when its PASSES operand is specified or 
defaulted as a value greater than (and for 2314, 2319, and 2305 the 
FLAGTEST=NO operand must also be specified) . Each track is tested and 
alternate tracks will be assigned to tracks that prove defective. 
Pre-existing flags and alternate assignments are ignored. Record zero 
is rewritten on all tracks. For some device types, home addresses are 
also rewritten on all tracks. Disk initialization can be performed on 
2305, 3330, 3340, and 3350 real (dedicated) disks and on 2314 and 2319 
minidisks as well as real disks. Initialization will generally be 
reguired when a disk (or a 2314 or 2319 minidisk) is in an initial or 
unknown state. Note: whenever disk initialization is done, disk 
formatting is also done. 

Note : Disk formatting will not reset (clear) the count field. 

DISK FORMATTING - Corresponds roughly to what is referred to as 
"initialization without surface analysis" or "guick DASDI"- It is 
invoked by a DADEF statement with PASSES=0 ,BYPASS=YES specified. 
Formatting consists of writing IPL records 1 and 2 standard OS volume 
labels on track cylinder and of writing an OS volume table of 
contents (VTOC). Since a disk's OS Format 4 label always contains a 
record of how many alternate tracks remain available for assignment, 
this information must be computed before the Format 4 label can be 
written. To compute this, IBCDASDI reads the "alternate tracks" 
cylinders. Disk formatting can be performed on any device, real or 
minidisk. Disk formatting will generally be required when standard 
labels must be created. 

ASSIGNING AN ALTERNATE TRACK - Invoked with a GETALT statement. This is 
an explicit request for an alternate to be assigned to the particular 
track that is specified. (Note that disk initialization may also assign 
alternate tracks.) Only the specified track is affected, so label and 
VTOC data is generally preserved. Alternate track assignment can be 
performed on 3330, 3340, and 3350 real (dedicated) disks and on 2314 and 
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2319 minidisks as well as real disks- 1 The last cylinder in any 2314 or 
2319 minidisk initialized by IBCDASDI is reserved and used as the 
"alternate tracks" cylinder. Assigning an alternate track explicitly 
will generally be required when a track becomes defective subsequent to 
disk initialization or when an intermittently bad track is missed during 
disk initialization. 



IBCDAJJDI Restrictions 

The IBCDASDI program cannot check to see if the 3330, 3340, or 3350 
space to be initialized was previously formatted. 

If you format only five cylinders of a 5-cylinder virtual disk of a 
3330, 3340, or 3350 but specify 20 cylinders to be initialized 
(CYLNO=20) , the IBCDASDI program does not initialize all 20 cylinders 
but merely updates the format 5 DSCB in the VTOC to indicate available 
space, without checking for the existence of 20 cylinders and without 
issuing an error message. Later, any attempt to use the sixth through 
the twentieth cylinder causes a Seek Check and the channel program 
abnormally terminates. 

When assigning alternate tracks explicitly, IBCDASDI must find a 
valid OS Format 4 label on the disk. If this label has been destroyed 
(ty CMS Format, for example) , or if the label does not apply to the 
present disk in its present state (for example, a no longer applicable 
OS Format 4 label might have been restored to the disk by the DDR 
utility) , then IBCDASDI must be used to perform the disk formatting 
function before alternate tracks can be assigned. The recommended 
procedure in this case is to: 

• Dump the entire disk to tape using the DDR utility 

• Format the disk using IBCDASDI 

• Assign the additional alternate tracks using IBCDASDI 

• Restore the data to the disk from the tape using the DDR utility 



*0n the 2305 drum, defective tracks should be rewired to alternate 
tracks by the CE rather than being flagged and assigned an alternate in 
the usual manner. In this case the fact that a track is defective and 
has an alternate wired in is transparent to all programming. (CF 
itself has no recovery procedures for "software assigned" alternate 
tracks on the 2305; however, an operating system running in one of its 
virtual machines might make use of them.) 
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Initialization with Surface Analysis (Not applicable to 3330/3340/3350) 
The IBCDASOI program: 

• Checks for tracks that were previously designated as defective 
(flagged) and have had alternates assigned. The program automatically 
assigns alternate tracks for 2314/2319 disk devices. This test must 
be suppressed vhen a disk is being initialized with surface analysis 
for the first time. This test must not be suppressed when a disk is 
initialized without surface analysis. 

• Performs a surface analysis of each track of a 2314 or 2319 and 
automatically assigns alternates (for 2314/2319s) , if necessary. 
Tracks that are available for use as alternates are checked first. 

• Writes a track descriptor record (record 0) , and erases the remainder 
of each track. When initializing a disk with surface analysis, 
IBCDASDI also writes a standard home address. 

• Writes IPL records on track (records 1 and 2) . 

• Writes volume label on track (record 3) and provides space for 
additional records, if requested. 

• Constructs and writes a volume table of contents (VTGC) . 

• Writes IPL program, if requested, on track (2314, 2305, 2319, or 
track 1 (2311). 

Initia lization with out Surface Analysis 
The IBCDASDI program: 

• Checks for tracks that were previously designated as defective 

(flagged) and have had alternates assigned. The program 
automatically assigns alternates (2314/2319 disk devices only). This 
test must not be suppressed. 

• For 3350 devices, HA/BO on all tracks is rewritten (to facilitate 
changing from ' 3330 compatibility mode to 3350 native mode and vice 
versa). Tracks that are flagged defective are surface analyzed and 
reclaimed if no errors are detected. The BYPASS and FLAGTEST options 
are ignored. The PASSES=0 option causes "QUICK DASDI" to be 
performed. 

• Writes a standard home address, a track descriptor record (record 0) , 
and erases the remainder of each track. 

• Writes IPL records on track (records 1 and 2) . 

• Writes volume label on track (record 3) and provides space for 
additional records, if requested. 

• Constructs and writes a volume table of contents (VTCC) . 

• Writes IPL program, if requested, on track (2314, 2305, 3330, 3340, 
or 3350 devices) or track 1 (2311 disks). 
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Note : The IBCDASDI program can only assign alternate tracks for real 
3330/334 volumes when they are specified by the GETALT statement- Even 
with the GETALT statement, the IBCDASDI program cannot assign alternate 
tracks for a 3330/3340/3350 minidisk because CP prevents a virtual 
machine from writing a home address record on these devices (effectively 
treating the write as a NO-OP) unless the device is dedicated to that 
virtual machine. Defective tracks are flagged and alternate tracks are 
assigned when the 3330/3340/3350 storage volumes are initialized at the 
factory. An IBCDASDI job that initializes a 3 330 performs the Quick 
DASDI function, which reads alternate tracks, decrementing by 1 the 
total number of alternates whenever an alternate is found defective or 
assigned, writes a volume label and VTOC, and writes an IPLTEXT if 
reguested. No surface analysis is performed and no home address or 
record is written on the primary tracks. The BYPASS and FLA GTE ST 
options of the DADEF statement are ignored. 

Disk packs for the 3340 are factory-shipped without flagged tracks 
and alternate track assignments. IBCDASDI»s "Quick DASDI" detects 3340 
customer-generated alternate track assignments. 

The IBCDASDI program cannot check to see if the 3330, 3340, or 3350 
space to be initiated was previously formatted. 

All utility control statements and operands must be preceded and 
followed by one or more blanks. 

The IBCDASDI program reguires control statements as input. Data on a 
control statement must not extend beyond column 71 except when a 
continuation of the statement is required. Then the statement must be 
broken off after a comma and a non-blank character must be placed in 
column 72. Then the statement can be continued on the next line, 
beginning in column 16 (and beginning only in column 16) . The 
statements must appear in the following sequence: 

1. JOB Statement — indicates the beginning of the IBCDASDI job. 

2. MSG Statement — defines the output device for operator messages. 

3. DADEF Statement — defines the DASD device to be initialized. 

4. VLD Statement — labels the volume and allocates space for 
additional labels. 

5. VTOCD Statement — controls the location of the 
volume-table-of-contents (VTOC) . 

6. IPLTXT Statement (optional) — separates service program control 
statements from IPL text statements. 

7. END Statement — ends an IBCDASDI job or IPL text. 

8. LASTCAFD Statement (optional) — ends series of stacked IBCDASDI 
jobs. 
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Initiali zing a 3350 (3 330 compatability mode to n ativ e mode ) 

To initialize a 3350 in native mode after conversion from 3330 or 3340 
compatability mode, the device must be attached (dedicated) to a virtual 
machine and either IEHDASDP or IBCDASDI must be run. This is necessary 
to allow alternate cylinders to be formatted and alternate tracks 
assigned. 

JOB Statem ent 

The JOB statement indicates the beginning of a job. The format of the 
JOB statement is: 



| [name] | JOB |[user information] I 

i 1 



MSG Stateme nt 

The MSG statement defines an output device for operator messages. It 
follows the JOB statement and precedes any function— defining statements 
that are associated with the IBCDASDI program. The format of the MSG 

statement is: 



| [name] | MSG | TODEV=xxxx,TOADDR=cuu | 

i 1 



wher e: 

TODEV=xxxx is the device type of the message output device (1403, 
1052, 2400, 3400, 3210, or 3211). 

TOADDR=cuu is the channel number (c) and unit number (uu) of the 
message output device. 
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DADEF Statement 



The DADEF statement defines the direct 
The format of the DADEF statement is: 



access volume to be initialized 



[name] 



DADEF 



TODEY=xxxxxx 

,TOADDR=CUU 

[,IPL=YES] 

( , 70LID=serial ) 

\,VOLID=SCRATCHJ 

[,MODEL=n] 

[ jCYLHO^nnn] 



[,FLAGTEST=NO] 
[,PASSES=n] 



[,BYPASS=YES] 



1 Applies to initialization with or without surface analysis 
2 Applies to initialization with surface analysis. 
3 Applies to initialization without surface analysis. 



where: 



TODEY=xxxxxx 

is a 4- to 6-character device 
device, specify either; 



type of the direct access 



2305 
2314 
3340 
3330 

3330-1 

3350 



for 3340 and 3344 
for 3330 Models 
compatibility mode 
for 3330 Model 
compatibility mode 
in native mode 



1 or 2 and 3350 in 3330-1 



11 and 3350 in 3330-11 



TOADDR=cuu 



IPL=YES 



is the channel (c) and unit address (uu) of the device. 
Specify the real address of the device if you are executing 
IBCDASDI on the real machine; specify the virtual address of 
the device if you are executing IBCDASDI on the virtual 
machine. 

writes an IPL program on the minidisk. An IPL initialization 
program must be written on a device to be used for system 
residence. If IPL is omitted, no IPL program is written. 



Bote: If you specify IPL=YES, you 
statement. 



lust also include an IPLTXT 



VOLID=serial 

is the volume serial number of the minidisk to be initialized. 
If "serial" matches the volume serial number found on the 
minidisk to be initialized, the operation proceeds. If it 
does not match, the operator is notified. 

VOLID=SCRATCH 

specifies that no volume serial number check is to be made. 
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MODEL=n is a decimal model number (1 or 2) . This operand is only for 
the 2305 and corresponds to the 2305-1 and 2305-2, 
respectively. 

CYLHO=nnn 

is a decimal number that specifies the number of cylinders to 
be formatted. If the CYLNO parameter is Quitted, IBCDASDI 
intializes the entire real volume specified. 

Note; If more cylinders are specified than are available on 
the minidisk, the message "Command Reject" is returned. 

FLAGTEST=NO 

(applies to surface analysis) specifies that the program is 
not to check for previously flagged tracks before surface 
analysis is attempted on this device. (FLAGTEST=NO applies 
only to 2314 and 2319 devices, and should be specified when 
the disk recording surface is initialized for the first time.) 

Note; Because no check is made for previously flagged tracks 
on drum volumes, FLAGTEST=NO is not coded when these devices 
are initialized. 

PASSES=n specifies the number of passes per track to be made in 
checking for defective tracks. PASSES is valid when surface 
analysis is to be performed or when a Quick DASDI is to be 
performed on a 3330, 3330-1, 3340, or 3350 volume. The value 
n can be through 255. The value indicates that a "Quick 
DASDI" is to be performed on a 3330, 3330-1, 3340, or 3350 
volume. For a 3330, 3330-1, 3340, or 3350 volume, a value 
other than zero causes record to be written on each track. 
PASSES=0 should be specified for 3330, 3340, and 3350 (full 
disk or minidisk) except when deliberately trying to free 
alternate areas assigned by GETALT in the prime data area, at 
which time PASSES-1 would have to be specified. No check is 
■ade for defective tracks on a 3330, 3330-1, 3340, or 3350. A 
value of 1 through 255 indicates the number of passes to be 
made per track for volumes other than a 3330, 3330-1, 3340, or 
3350 volume. If PASSES is omitted, one pass is made per 
track. 

BYPASS=YES bypasses the rechecking of any tracks that are already 
flagged as defective. If BYPASS is omitted, flagged tracks 
are rechecked and those found defective are automatically 
assigned alternates. For 3330 or 3350 devices, this operand 
is ignored and BYPASS=YES is assumed. 
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¥LD Statement 



The ?LD statement labels the volume, 
is: 



The format of the VLD statement 



[name] 



VLD | NEWVOLID=serial 

r t 

IrZOLPASSfOI 
|,VOLPASS=1| 

L J 

[ ,OWNERID=XXXXXXXXXX] 
[,ADDLABEL=n] 



where; 

HEWVOLID=serial 

is a one-to-six character volume serial number. 

V0LPASS=1 sets the volume security bit to 1. 

VOLPASS=0 sets the volume security bit to 0. 

If VGLPASS is omitted, the volume security bit is set to 0. 

OWNERID=XXXXXXXXXX 

is a one-to-ten character field that identifies the ovner of 
the volume. 

If OWHERID is omitted, no identification is given. 

Note: The ownerid CP370 is reserved for use by DHKFMT and 
cannot be specified. 



ftDDLABEL=n 



is a number between one and seven that indicates the total 
number of additional labels for which space is to be 
allocated. 

If ADDLABEL is omitted, is assumed. 



VTOCD Statement 



The VTOCD statement contains information for controlling the location of 
the volume table of contents. The format of the VTOCD statement is: 



i[name] 

I 

i 



i VTOCD jSTRTADR=nnnnn 
I | ,EXTENT=nnnn 



where: 

STRTADR=nnnnn 

is the one to five byte track address, relative to the 
beginning of the minidisk, at which the volume table of 
contents is to begin. The VTOC cannot occupy cylinder 0, 
track 00, or any alternate track. 
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BXTEHT=nnnn 

is the length of the volume table of contents in tracks. The 
number (deciial) of entries per track for each type of device 
is given belov. 



Device VTOC E 


n tries, 


2301 


63 


2314/2319 


25 


2311 


16 


2305-1 


18 


2305-2 


34 


3330-1,2 


39 


3330-11 


39 


3340 


22 


3350 (in native mode) 


46 



tbi m»m cj. .« .l **. — .» ~ wu 

The IPLTXT statement separates service program control stateaents from 
I IPL program text statements. It is required only when IPL=IES is coded 
on the DADEF statement and IPL text is included. The statement consists 
of the characters IPLTXT, followed by blanks. 

When IPL text is included, the END statement must follow it and EHD 
■ust start in column 2. 



EHD Statement 

The EID statement denotes the end of the job. It appears after the last 
function-defining statement. The format of the EHD statement is: 

i 1 

I [name] I END |[user information] I 

t , , - ■■ , J 



LASTCARD Statement 

The LASTCARD statement is required only when a IBCDASDI job or a series 
of stacked IBCDASDI jobs is followed by other statements on the control 
statement input device. The LASTCARD statement must follow the last EHD 
statement applying to an IBCDASDI job. It consists of the operand 
LASTCARD, followed by blanks. 
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ASSIGNING AN ALTERNATE TRACK 

I BCDAS DI: (1) analyzes a track and, if necessary, assigns an alternate 
or (2) bypasses testing, and assigns an alternate. Yon must specify the 
tracks for which you wish alternates with a GETALT statement. 

Assigning an Alternate Track (with Testing) : An alternate track (if 

available) is assigned for a track specified for testing and found 

defective. If the defective track has had an alternate previously 
assigned, a new alternate track is assigned. If the defective track is 

an unassigned alternate track, it is flagged to prevent its future use 

and another alternate track is selected. The alternate track address is 
made known to the operator. 

If a track is tested and found to be "not defective," no alternate is 
assigned. The operator is notified by a message. 

Assigning an A lternat e Track (without Testing) : The program's defective 
track checking feature can be bypassed, and an alternate track can be 
assigned for any track, whether it is permanently defective or not. If 
the specified track is an alternate, a new alternate track is assigned. 
If the specified track is an unassigned alternate, it is flagged to 
prevent its future use. 

Note; For 3330, 3340, and 3350 minidisks you must assign the alternate 
on the real disk. Any references thereafter to that track oi 
minidisk are referred to the alternate track. 
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GETALT Statement 



Any number of alternate tracks can be assigned in a single job by 
including one GETALT statement for each track. The GETALT statement can 
follow the MSG statement. The format of the GETALT statement is: 




GETALT |TODEV=XXXX 
j ,TOADDB=CUU 
j , TRACK=cccchhhh 
I ,VOLID=serial 
|[,FLAGTEST=NO] 
|[ ,PASSES=n] 
|[ ,BYPASS=YES] 
|[,MODEL=n] 



where: 



TODE?=XXXX 



is the device type of the direct access device. 



TOADDR=cuu 

is the direct channel number (c) and unit number (uu) of the 
direct access device. 

TBACK=cccchhhh 

is the address of the track for which an alternate is 
requested, where cccc is the cylinder number and hhhh is the 
head number. These are hexadecimal numbers. 

VOLID=serial 

is the volume serial number of the disk or minidisk to which 
an alternate track is to be assigned. If serial matches the 
volume serial number found on this disk or minidisk, the 
alternate track assignment proceeds. If it does not match, 
the operator is notified. 

FLAGTEST=NO 

(used when testing before assigning an alternate) specifies 
that the program not check for a previously flagged track 
before a surface analysis is attempted on this track (disk 
storage devices only) . 

PASSES=n (used when testing before assigning an alternate) specifies 
that the program's defective track checking feature is to make 
n number of passes (from 1 to 225) when performing a surface 
analysis. If PASSES is omitted, one pass is lade on this 
track. 
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BYPASS=YES 

is that the program* s defective track checking feature is to 
be bypassed. If BYPASS is onitted, the prograi assigns an 
alternate only if it finds that the specified track is 
defective. 

MODEL=n is a decimal model number (1 or 2) . This operand is only for 
the 2305 and corresponds to the 2305-1 and 2305-2, 
respectively. 

Note; A list of defective tracks (if any) is provided with new IBM disk 
storage volumes. Refer to this list when using the IBCDASDI program for 
the first time. After initialization, include the GETALT statement in an 
IBCDASDI job to assign an alternate track for each track on the list. 
Subsequent IBCDASDI jobs "remember" those defective tracks, unless the 
FLAGTEST=NO option is specified for those jobs. 

Ex ample 1 

The example below shows the control statements that might be prepared to 
initialize a dedicated 3340 disk that is to be initialized by running 
IBCDASDI in a virtual machine. The disk is to be labeled VMRES and it 
is mounted on unit address 240. 

INIT240 JOB 

HSG TODE¥=1052,TOADDR=009 

DADEF TODEY=3340,TOADDR=240,VOLID=SCRATCH, C 

FLAGTEST=NO,BYPASS=NO 

YLD NEWYOLID=YHRES 

YTOCD STRTADR=1,EXTENT=1 
END 

Since the PASSES operand was not specified, it defaults to PASSES=1 and 
a non-Quick DASDI function is performed. All tracks, including any that 
were previously flagged as defective, are tested. Flagged tracks that 
test okay are recovered (not flagged) . Any tracks that do not pass the 
test are flagged and an alternate track is assigned. 

Example 2 

The example below shows the control statements that might be used to 
explicitly assign alternate tracks to two tracks on the same disk shown 
in Example 1. It is assumed that these two tracks were found to be 
defective when the disk was put into use, subsequent to its 
initialization in Example 1. Once again the disk must be dedicated to 
the virtual machine in which IBCDASDI will be run. 

HOREALTS JOB 

HSG TODEV=1052,TOADDR=009 

GETALT TODEV=3340,TOADDR=240,YOLID=YHRES. C 

BYPASS=YES,TRACK=00FB0003 
GETALT TODEY=3340,TOADDR=240,YOLID=VHRES, C 

BYPASS=YES,TRACK=011C0005 
END 

The TRACK operands specify the hexadecimal CCHH addresses of the two 
tracks that get flagged as defective. 
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Example 3 

The example below shows the control statements that might be prepared to 
initialize the 2314 minidisk LIBRES for OS data set residence. Note 
that the label of the real volume, CPV0L1, cannot be used as the VOLID 
operand. 

JOB 

MSG TODE¥=1403,TOADDR=0QE 

DADEF TODEY=2314,TOADDR=231,VOLID=SCRATCH,CYLNO=50 

VLD NEWVOLID=LIBRES,OWNERID=OPERATIONS 

VTOCD STRTADR=10,EXTENT=5 

END 

The desired size of the minidisk is specified through the CYLNO 
operand. The value specified includes one cylinder reserved for 
alternate track assignment; a user assigned n cylinders has n-1 of these 
initialized for his use, and the nth cylinder used for any alternate 
track assignment. The minimum size of a minidisk can be computed from 
the formula below. In it, N represents the minimum number of cylinders, 
and K represents the number of recording heads of the device. The 
SIZE-OF-VTOC value should be in tracks, and the result of the division 
should be rounded to the next highest integer. 

N = 2 + (SIZE-OF-VTOC / K) 

Note: For 2305 Models 1 and 2, 3330, 3340, and 3350 devices, all n 
cylinders of a minidisk are assigned for your use. No allowance is made 
for alternate track assignment. 

IH¥0KING THE IBCDASDI PROGRAM 

The IBCDASDI program is invoked for minidisks by specifying the operand 

. .. ,CILNO=nnn 

on the DADEF control statement (discussed previously) . This control 
statement is passed to the IBCDASDI utility for processing. This 
operand specifies the size, in cylinders, of the minidisk to be 
initiated. 

The IBCDASDI program, which is distributed as a CHS file with a 
filename of IPL and a filetype of IBCDASDI, should be spooled to your 
own virtual card reader. Control statements for the program can follow 
the last card or card image for the program, or can be entered via a 
separate input device. 

To execute the IBCDASDI program: 

1. Make sure ECMODE is off for your virtual machine; use the QUERY 
command to determine this. Ose the SET command to modify if 
required. 

2. Spool a copy of the IBCDASDI object module to your virtual card 
reader, or mount and attach the tape containing the object program. 

3. Load the object program from the virtual reader or tape by issuing 
the CP IPL command for the appropriate virtual device address. 
When the program is loaded, an enabled wait state is entered with 
the address field of the PSH containing the hexadecimal value FFFF. 
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4. When the program is loaded and waiting for input, signal attention 
froo the virtual console device. The message 

DEFINE INPUT DEVICE 

is sent to your virtual console. Enter the following response from 
the virtual console: 

INPOT=type,cuu 

where; 

type is the device type of the device containing the control 
statements. Valid device types are 2400, 2540, 3410, 3420, 
and 3505. 

cuu is the device address of the device containing the control 
statements. 

Control statements are printed on the message output device. At the 
end of job, the END OF JOB message is printed on the message output 
device and the program enters the wait state. 



VMFDUMP Service Program and How To Use It 



CHEATING DUMP FILES 

Conditions can occur during VM/370 processing that cause an abnormal 
program ending (abend) . The system operator can cause this abend 
condition by pressing the SYSTEM RESTART key on the system console. If 
VM/370 1 s control program (CP) recognizes an error condition or program 
situation where program recovery is not possible or desirable, abend 
occurs. The abend procedure creates a historical record of the incident 
by dumping register and processor storage contents to a previously 
designated device. 

The extent of the dump operation as well as the device that captures 
this information is specified by operands of the CP SET command. The 
format of the CP SET DOMP command is: 

i ' ■ 1 

I I r I I 

I SET I DOMP /raddr) |CP | I 

I | \kTJT0 } | ALL | I 



raddr (real device address) designates either the system printer or 
a readied nine— track tape drive (three hexadecimal digits) . 
If the printer address is specified, the data is printed 
online and system operations as well as virtual machine 
operations are suspended until the dump operation finishes and 
the subseguent system automatic restart operation occurs. 
This dump is unformatted. The printed dump is the end result 
of specifying the system printer in raddr. No further 
processing or copying of this file is possible. If raddr 
refers to a tape drive, the dump data must fit on one reel of 
tape. VM/370 does not support multiple tape volumes. The 
historical data on the tape is in print line format. Tou can 
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aoto 



CP 
ILL 



further process this historical file by user-created prograis 
or CBS commands. See "How To Print a CP Abend Dump from Tape" 
later in this section for an example of hov CHS can do this. 

spools abend duips to a virtual card reader with a class of D 
for a specific userid. This userid either is assigned during 
systei generation to a specific virtual Machine user, or 
defaults to the userid of OPERATNS. Thus,, only the specified 
User with a privilege class of C or E can invoke VHFDOHP and 
achieve desired results. The dump spool file can be 
manipulated by the user just like any other spool file, except 
that it can be interpreted correctly only by the VHFDOHP 
program. The device type and address of this virtual card 
reader can be determined by issuing a QDIRY DUMP command. The 
system then responds with the device type and the channel and 
unit address of the system dump device. 

dumps only CP storage. 

causes all of processor storage (that is, all data that 
relates to CP as well as all virtual machines) to be dumped to 
the selected device. If the ALL option is not specified, then 
the system dumps those areas that pertain to CP, and not those 
areas that pertain to user virtual machine operations. 



Only dumps created by SET DOHP AUTO can be used by the IPCS VHFDOHP 
service program 



OSING THE VHFDOHP COHHAHD 



The IPCS VHFDOHP command uses the DHHEDH program to read the CP spool 
reader file that contains the system dump and write it on the CHS 
A-disk. The DHHEDH program then reads the dump information from the CHS 
disk, selecting and formatting various control blocks, which it directs 
to the spooled printer (per VHFDOHP operands) . The program also prints 
a hexadecimal dump, then erases or retains the CHS file, depending on 
the options chosen. Only users with privilege class C or E can invoke 
VHFDOHP. In addition to producing formatted dump output, VHFDOHP 
automatically generates a problem report file from abend dump 
information and operator-prompted responses which aids in problem 
analysis, is described fully in the VH^320 Interactive Problem Control 
S yst em (IPCS) Oser's Guide. The format of the VHFDOHP command is: 



VHFDOHP 



r i 

I PRBnnnnn | 

L J 



r 

| ERASE 

INOHAP 

INOHEX 

INOFORH 

jHOVIRT 

L 



where: 



PRBnnnnn 



specifies the 
problem. This 
problem report 



dump number previously assigned for this 
dump exists as a CHS file PRBnnnnn DOHP. Ho 
is produced. If no number is specified, the 
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dump is read froa the spool file and assigned the next 
sequential problem number (PRBnnnnn) as the dump number. 

ERASE specifies that the dumF being processed is to be erased, 

NOMAP specifies that a load map is not to be printed. 

NOHEX specifies that the hexadecimal portion of the dump is not to 
be printed. 

NOFORM specifies that no formatted control blocks are to be printed. 

N07IRT specifies that only the real machine control blocks are to be 
formatted. This option is ignored if NOFORM is also 
specified. 



Usage Notes: 



2. 



The current CP load map (NOC MAP) is required for VMFDOHP function 
to execute correctly. This file must reside on the A-disk of the 
IPCS virtual machine used to invoke VMFDUMP. If YHFDUMP does not 
find NUC MAP or finds that it is invalid, you are asked to enter 
the name of the current load map. You may add the load map to the 
dump by using the MAP subcommand of DUMPSCAN. 

The dump specified by PRBnnnnn will be handled according to the 
options used. When a dump number is specified in the VMFDUHP 
command, no data extraction occurs. The following example is the 
suggested command for processing a new dump: 

VMFDUMP NOFORM NOHEX 



where: 



NOFORM 
NOHEX 

VMFDUMP will: 



inhibits the printing of formatted control blocks 

inhibits the printing of the hexadecimal portion of 
the dump. 



Read the dump from the spool file. 

Assign the next sequential problem number as the dump number. 

Perform the data extraction. 

Create a problem report. 



The filenames of 
PRBnnnnn DUMP. 



dumps created by the VMFDUMP are of the form 



Upon completion of the problem report generation function of the 
extended VMFDUMP, a search is made of the symptom summary file for a 
possible duplicate problem. Up to ten possible duplicate problems are 
displayed with their associated status. Whether or not the problem was 
a duplicate, an entry is made in the symptom summary file for this 
problem. 
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SAMPLE OF INITIATING THE VMFDUMP OPERATION 

Following typical logon procedures, the user can take the following 
steps to initiate a VMFDUMP operation. 

query rdr 

ORIGINID FILE CLASS 8ECDS CPY HOLD 
SYSTEM 0126 D DMP 000065 00 NONE 
SYSTEM 0088 D DMP 000061 00 NONE 

Entering QUERY READER discloses that these files are system 
generated class D files. This alerts you to the fact that the 
files are CP Dumps. These dumps, although not usable in their 
present state, are translated by subsequent VMFDUMP 
processing. 

ipl CMS 

CMS 08/27/75 WED 09.45.20 

vmfdump noform nohex 

DO YOU WISH TO USE THE 'IPCS* VERSION OF VMFDUMP? (YES OR NC) 

yes 

VM/370 DUMP, EXTRACT, EDIT, AND PRINT 

VM/370 SYSTEM ABEND CODE PRG005 DATE 08/26/75 TIME 13.42 

DO YOU WANT THIS DUMP? (YES OR HO) 

yes 

CREATING FILE PRB00013 DUMP A1 

(data extraction process) 

ASSIGNED PROBLEM NUMBER PRB00013 

CMS 08/29/73 WED 09.45.20 

3 

ENTER FN FT FM OF SUPPORTING DATA AND DESCRIPTION 

E.G. PROB00013 CONSOLE A1 

(User enters pertinent data) 

ENTER ADDITIONAL TEXT 80 CHARS. PER LINE 
ENTER TEXT OR NULL 

(User enters needed text or presses return key or its 
equivalent) 

THE FOLLOWING PROBLEM (S) ARE POSSIBLE DUPLICATES, 
00012 OPENUSER 08/19/75 

R; 

CMS is loaded into the user's virtual machine and VMFDUMP is 
invoked. In this example, he elects to create a CHS dump 
file. The processing messages related to creating the file 
follow. If the file is processed and saved using the VMFDUMP 
program, the CP spool file is erased, and the newly created 
CMS file becomes PRBnnnnn DUMP, where nnnnn is a number from 
00001 through 99999. 

Note; If VMFDUMP terminates or enters a loop condition because of an 
unrecoverable or invalid situation encountered while attempting to 
format a dump, VMFDUMP should be invoked again with the NOFORM operand. 
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April 1, 1981 

HOW TO PRINT A CHS DUHP PILE 

Use the VHFDUHP command to print a previously created dump file under 
CMS by entering: 

VMFDUHP PBBnnnnn [options] 

at the terminal. The message: 

PRINTING FILE •PRBnnnnn Dnn DUMP 1 

then occurs at the terminal. When the specified file has been formatted 
and printed, one of two completion messages is displayed: 

DUHP FILE 'PRBnnnnn Dnn DUHP* PRINTED AND KEPT 

— or — 

DUHP FILE 'PRBnnnnn Dnn DUMP* PRINTED AND ERASED 

HOW TO PRINT A CP ABEND DUMP FROH TAPE 

When the CP abend dump is set to a tape, the records are 132 characters 
long, unblocked, with a blocksize of 132 and carriage control 
characters. 

If the CP dump unit has been specified as a tape drive, and one or 
more dumps have been placed on the tape, use the following procedure to 
print the dumps. 

1. Log on to the VH/370 system with any userid that has the capability 
of running CHS. No other special privilege classes or options are 
reguired. 

2. Attach a tape drive to the virtual machine as address 181* 
3« Mount the tape containing the CP abend dumps. 

4. IPL the CHS system and perform the usual access reguirements. 

5. Issue the following CHS commands: 

FILEDEF ddnamel PRINTER (RECFM UA LRECL 132) 

FILEDEF ddname2 TAP1 (9track DEN nnnn RECFM U LRECL 132) 

MOVE ddname2 ddnamel 

cp close prt 

Step 5 can be repeated for as many dumps as are on the tape. Note 
that the CP dump routines write two tape marks at the end of each file. 
Therefore, to process the next dump, the TAPE FSF command line must be 
issued to position the tape for reading the next dump file. 



Section 4. VM/370 Service Programs 197 



Page of GC20-1 806-9 As Updated April 1, 1981 by TNL GN25-0834 



NETWORK DUMP OPERATIONS 



If 3704/3705 operations are erratic, fatal hardware errors occur, or 
some other internal error appears, the Communications Controller's 
storage should be dumped. The NETWORK DUMP command dumps the contents 
I of 3704/3705 storage for EP 3704/3705 control programs, if unit check or 
IPL reguired conditions are detected. 

The format of the .NETWORK command with the DUMP operand is: 



r t 

NETWORK | DUMP raddr IIMMEDI 

IAUT0 | 
I OFF | 

L J 



wher e 
raddr 
IMMED 



is the real hexadecimal address of the 3704/3705. 

is the default operand; it forces an immediate dump. The 
IMMED operand, if specified, does not reload the control 
program. Before 3704/3705 resources can be used again, the 
control program must be reloaded. To reload the control 
program after the "NETWORK DUMP raddr IMMED" command has 
executed, use the "NETWORK LOAD raddr ncpname" command. 



If the IMMED operand is specified, a check is made to 
determine whether the "IPL reguired" sense status is present. 
If it is not, the following message occurs: 

DMKNET461R CTLR raddr IPL NOT REQUIRED; ENTER YES TO 
CONTINUE: 

This pause in operations allows the operator an opportunity to 
check the NETWORK DUMP command line before engaging or 
terminating the operation. 



AUTO 



OFF 



causes a dump if VH/370 subseguently detects a unit check 
condition or "IPL reguired" condition. If AUTO is specified, 
each time a dump is taken, the Communications Controller is 
reloaded with the 3704/3705 control program that was 
previously active. 

resets a previously set AUTO (automatic dump) status. 



Note : The dumps produced by the NETWORK command cannot be processed by 
the VMFDUMP service program. NETWORK-initiated dumps are processed by 
the NCPDUMP (Network Control Program DUMP) service program created for 
this task. 
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IMCPDUMP Service Program and How To Use It 

NCPDUHP is a CHS command. It processes CP spool reader files created by 
3705 dumping operations, that is, dump files that are produced as a 
result of the CP NETWORK command specified with the DOHP operand and 
either automatic or immediate mode. 

The NCPDUHP file processing operation can include: 

• Erasing a specific CMS NCPDUHP file after printing it. 

• Formatting the dump. 

• Printing the dump. 

• Assigning an identifier to the CHS NCPDUHP file. 

• Creating the CHS NCPDUHP file from the spool file. 

Although NCPDUHP is a CHS command, its use is restricted to the user 
identified by the SYSDUHP operand of the SYSOPER macro in DHKSYS during 
YH/370 system generation. The operation of NCPDUHP is similar to 
VHFDDHP operations. A general description of the NCPDUHP operation 
follows the command description. 

The NCPDUHP command has the following format: 



| NCPDUHP | [DUHPxx] [ ([ERASE ][ NOFORH ][ HNEH0NIC][ NCPBUFF][) ]] 



where: 

DUHPxx is the filename of a CHS file containing a 3704/3705 
Communications Controller program dump. This dump was created 
by a previously invoked NCPDUHP command with the ERASE operand 
not specified. 



ERASE erases the current CP DUHP file or 
(filename), saved CHS file. 



a specified DUHPx: 



NGFGRH 



specifies that a formatted control block is not desired. 



HNEHONIC includes 3705 Assembler mnemonic operation codes in the 
printed output. 

HCPBUFF specifies that a formatted listing of the NCP buffer pool is 
desired. 

The NETWORK command invoked with the DUHPxx operand, as stated 
previously, produces CP files that contain the contents of a designated 
3704/3705 Communications Controller unit buffer. These CP files reside 
as a spooled reader input assigned to a system-designated user. The CHS 
NCPDUHP command invoked by this user formats (if requested) and prints 
the contents of these files. 

The NCPDUHP program creates a CHS file with a filename DUHPxx and a 
filetype of NCPDUHP, and erases the original spooled NETWORK initiated 
dump reader file. The created CHS file is erased if you specify ERASE; 
otherwise it is kept. 

A maximum of ten dumped spooled files can be processed and saved, and 
later recalled, if necessary, by the system assignment of an xx 
identifier suffix to the CHS DUHPxx filename. The "xx" is a decimal 
number from 00 to 09, depending on any existing files of a similar name. 
For example, if the files DUHP00 NCPDUHP and DUHP01 NCPDUHP already 
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exist, the new file would be called DUMP02 NCPDUMP. The file thus 
created is retained for later use unless the ERASE option is specified, 
in which case the file is erased immediately after the dump is printed. 



ZAP Service Program and How To Use It 

ZAP is a CMS command that modifies or dumps MODULE, LOADLIB, or TXTLIB 
files. It may be used to modify either fixed or variable length MODULE 
files. It is for use by system support personnel only. 

Input control records control ZAP processing. They can be submitted 
either from the terminal or from a disk file. Using the VEB and REP 
control records, you can verify and replace data or instructions in a 
control section (CSECT) . Using the DUMP control record, you can dump 
all or part of a CSECT, or an entire member of a LOADLIB or TXTLIB file, 
or an entire module of a MODULE file. 



The format of the ZAP command is: 




MODULE ) 

LOADLIB > [libname 1 ... Iibname3][ (option. ..[) ]] 

TXTLIB j 

options : 

r i r i 

I TERM I I PRIST I 

IIHPUT filename | INOPRINTI 

L J L J 



wh ere ; 

MODULE 

LOADLIB 

TXTLIB 



indicates the type of file that is to te modified or dumped 



libname is the library name containing the member to be modified or 
dumped. You can specify one to three library names. The 
libname is valid only for LOADLIB and TXTLIB files. 

Op ti o n s : 

r t 

TEIMS | PRINT | 
INOPRINTI 

L J 

indicates that input to the ZAP service program is submitted 
through the terminal. If you specify TERM, the prompting 
message ENTER: is issued, and you can then enter input control 
records up to 80 characters long. If you specify PRINT with 
TERM, all output prints on the printer, but only error 
messages display at the terminal. If you specify NOPRINT with 
TERM, nothing prints on the printer. All output except 
control records displays at the terminal. 

r i 

INPUT filename | PRINT | 
INOPRINTI 

L J 

specifies that input is submitted froi a disk file, filename. 
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This file must have a filetype of ZAP* and must be a fixed 
80— byte sequential file residing on any accessible device. If 
you specify PRINT with INPUT filename, all output produced by 
the ZAP service prograa prints on the printer. In addition, 
connands and control records in error and error Messages 
display at the terminal. If you specify NOPRIHT with INPDT 
filename, nothing prints on the printer. All output displays 
at the terminal. 



Figure 12 shows the resulting output resulting from valid option 
combinations: 



OPTIONS 



PRINT 



I 



NOPRINT 



INPUT 



I Commands and control records j Everything on the 

j in error and error messages j terminal. Nothing on 

I on the terminal. Everything j the printer. 

I to printer. j 



I Only error messages on the | Everything except control 
TERN j terminal. Everything on the j records on the terminal. 
j Printer. j Nothing on the printer. 

■ ; 

Figure 12. Valid Options and Their Output 



ZAP INPUT CONTROL RECORDS 



I Eight types of ZAP control records exist: DUHP, NAHE, BASE, VER or 
I VERIFY, REP, LOG, COHHENT, and END. 

ZAP control records are free-form and need not start in position one 
of the record but the ZAP program can accept only 80 characters of data 
for each control record. Separate all information by one or more 
blanks. All address fields including disp (displacement) fields in VER 
and REP control records must contain an even number of hexadecimal 
digits, to a maximum of six digits (OD, 02C8, 014318) . Data fields in 
VER and REP control records must also contain an even number of 
hexadecimal digits, but are not limited to six digits. 

If you wish, you may separate the data anywhere by commas (for 
example, 83256482 or 8325,6482). The commas have no effect on the 
operation. 

The program sets the NOGO switch on if a control record is found to 
be in error. A file cannot be modified once the NOGO switch is turned 
on. The next valid NAHE record turns the NOGO switch off. This means 
that if the control record is the NAHE record, all succeeding records 
are ignored until the next NAHE, DUHP, or ENE record. For any other 
error, only REP control records that follow are ignored. 



DUHP Control Record 



The DUHP control record resets the NOGO switch off. The DUHP contrcx 
record must not immediately precede a BASE, VER, or REP control record. 
A NAHE control record must precede the BASE, VER, and REP control 
records (if any) that follow a DUHP control record. 
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The DUMP control record allows you to dump a portion or all of a 
specified control section, or the complete member or module. The format 
of the output of the dump is hexadecimal with an EBCDIC translation of 
the hexadecimal data. 

The DUMP control record is optional- The format of the DUMP control 
record is: 



DDHP J member name) jcsectname [startaddress [endaddress ]] 
\ modulename J |ALL 



w here : 

membername 

is the name of the member to be dumped, or the member that 
contains the CSECT (s) to be dumped. This member must be found 
in one of the libraries specified in the ZAP command line. 
However, if the library is a CHS TXTLIB, its directory does 
not contain member names. Therefore, the program ignores the 
member name (although you must specify it) , and the program 
searches for the csectname (which you must specify) . 

modulename 

is the name of the module to be dumped, or the module that 
contains the CSECT (s) to be dumped. If you specify a module 
that has no loader table, the program dumps the entire module. 

csectname is the name of the control section that is to be dumped. If 
you do not specify csectname, the program dumps only the first 
CSECT. The csectname is required for CHS TXTLIBs, optional 
for OS TXTLIBs, LOADLIBs, and HOEULE files. (See the 
discussion of csectname under "Same Control Record.") You must 
not specify csectname for a module created with the HOHAP 
option. 

ALL specifies to the program to dump all CSECTs within the 
specified member or module. You can specify ALL for HODDLE 
files, LOADLIBs, and OS TEXTLIBs, but not for CHS TXTLIBS. If 
you wish to dump all the CSECTs in a member of a CHS TXTLIE, 
you must issue a separate DOHP control record for each CSECT. 

startaddress 

is the location within the specified CSECT where the dump is 
to begin. This must be two, four, or six-hexadecimal digits. 
The start address is the displacement from the beginning of 
the CSECT= For example, if you wish to start dumping at 
address 08 in a CSECT that begins at location 400, you specify 
start address 08, not 0408. 

endaddress 

is the last address to be dumped. This must be two, four, or 
six-hexadecimal digits. If you specify no address, the 
program dumps from the start address of the CSECT to the end 
of the CSECT. Note that start and end addresses apply only 
when you specify a csectname. 
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N AME Control Record 

The NAME control record specifies the member or module and CSECT that 
contain the data to be verified or replaced by the ZIP operation. The 
format of the NAME control record is: 



NAME i membername ) [csectnaoe] 
1 modulename J 



w here ; 

j membername ) 
(modulename/ 

is the member or module that you want to be searched for the 

desired CSECT. 

csectname is the name of the desired control section. You must specify 
csectname if the CSECT you wish to modify is in a CBS TXTLIB 
(that is, TXTLIB created by the TXTLIB command from CBS TEXT 
decks that do not have a NAME card following the END card) . 
The directory of a CHS TXTLIB contains only CSECT names and no 
member names. The CSECT name specified in the NAME record is 
compared with CSECT names in the directory. If a CSECT match 
is found and no member name match is found, the member 
selected is the one that contains the CSECT name. .The 
csectname is optional if the CSECT you wish to modify is a 
LOADLIB or an OS TXTLIB (that is, a TXTLIB created by the 
TXTLIB command from CBS TEXT decks that have a NAME card after 
the END card) . The dictionaries of the specified libraries 
are searched for the member name and the member is then 
searched for the CSECT name, if you specified one. If you do 
not specify csectname for a LOADLIB or an OS TXTLIB, the 
program uses the first control section. The csectname is 
optional for a MODULE file. The module named in the NAME 
control record is located and, if you specified csectname, the 
first record is read to determine the number of records in the 
module and the availability of a leader table, which the 
program can then search for the csectname. If you do not 
specify csectname, the program uses the beginning location of 
the module. lou are not allowed to specify csectname if the 
module was created with the NOBAP option. The NABE control 
record must precede the BASE, VER, and REP control records. 
If it does not, the program sets the NOGO switch on. 



BASE Control R ecord 

The BASE control record adjusts displacement values for subsequent VEB 
or REP control records for a CSECT whose starting address is not 
location zero in an assembly listing. The format of the BASE control 
record is: 



I" 

1 
1 


BASE 


address 


• 

1 

I 
i 


1 

I— 









Section 4. VB/370 Service Programs 203 



where: 

address is the starting address of the CSECT. The address must be 
two, four, or six hexadecimal digits. For example, for a 
CSECT starting at location 400, you would specify the BASE 
0400 in the BASE control record- If a subsequent VER card 
requests verification of location 0408, the BASE of 0400 is 
subtracted from 0408,, and the program verifies location 08 in 
the CSECT. This example applies if you specify TITLIB, 
LOADLIB, or HODOLE and the module map is present. However, if 
no module map is present for a MODULE file (that is, the 
module was generated with the HOBAP option) , then all 
operations are performed as if the BASE address is location 0. 
For example, if you specify a BASE of 400 and the address you 
wish to inspect or modify is 408, then you must specify 08 and 
not 408 in REP and VER control records. The address in this 
case is from the start of the module. If you do not specify 
csectname in the NAME control record, you cannot specify any 
BASE value other than 00. The BASE control record is 
optional. See the discussion under "VER or VERIFY Control 
Record." If specified, the BASE control record must follow 
the HAME record, but it need not follow the HAME record 
immediately. For example, you could have the following 
sequence of control records: NAME, VER, REP, EASE, VER, REP. 



IJB 51 USUI Control Record 

The VER control record requests verification of instructions or data 
within a CSECT. If the verification fails, the program does not perform 
a subsequent REP operation until it encounters another SAME control 
record. 

The VER control record is optional. More than one VER record can 
follow a single HAME record. 



The format of the VER control record is: 



/ VERIFY | 
\ VER J 



disp data 



where: 

disp is the hexadecimal displacement of the data to be inspected 
from the start of the CSECT, if you did not submit a BASE 
control record for this CSECT. If you did submit a BASE 
control record, then disp is the actual location of the data. 
The disp must be two, four, or six hexadecimal digits. This 
displacement does not have to be aligned on a fullword 
boundary. If this displacement value is outside the limits of 
the CSECT specified by the preceding HAME control record, the 
VERIFY control record is rejected. 

data is the data against which the data in the CSECT is to be 
compared. This must be an even number of hexadecimal digits. 
For example, if the location you wish to verify is 3CC, and 
the CSECT begins at location 2B0, you can either issue: 
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BASE 02B0 
VER 03CC data 

or you can omit the BASE control record, subtract the CSECT 
start address from the address of the data, and issue: 

VER 011C data 



This also applies to the 
record. 



disp operand of the REP control 



Note: If the VER control statement references a TXTLIB file 
that contains ORG statements causing more than one occurrence 
of an address, only the first occurrence is tested when the 
displacement on the VER statement references the ORG statement 
addresses. 



REP Control Record 



The REP control record modifies instructions or data at the specified 
location within the CSECT that you specified in a preceding SAME control 
record. The data specified in the REP control record replaces the data 
at the CSECT location specified by the disp operand. This replacement 
is on a "one— for-one" basis; that is, one byte of data defined in the 
control record replaces one byte of data at the location that you 
specified. If the replacement fails, the program does not perform 
additional REP operations until it encounters another NAME control 
record. 



The REP control record is 
follow a single NAME record. 



optional. More than one REP record can 



The format of the REP control record is: 



| REP disp data 



where; 



disp is the hexadecimal displacement of the data to be replaced 
from the start of the CSECT, if you did not submit a BASE 
control record for this CSECT. If you did submit a BASE 
control record, then disp is the actual location of the data. 
The disp must be two, four, or six hexadecimal digits. This 
displacement need not address a fullword boundary. If this 
displacement value is outside the limits of the CSECT being 
modified, the program does not perform the replacement 
operation. 

data is the data that is to replace the data in the CSECT. This 
must be an even number of hexadecimal digits. 



N ote : Although you do not have to 
data, you should do so to make sure 
you expect it to be. 



verify a location before replacing 
that the data being changed is what 
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I LOG Control Record 

The LOG control record allows the user to specify a unique fix number 
for the lodule specified in the NAME control record. Fix numbers are 
recorded in a log file associated with the named module. The format of 
the LOG control record is: 



I r i 

I LOG {fixnum} | filetype [user data] | 
I I ZAPLOG | 



where: 

fixnum specifies the number associated with the fix. Its length may 
vary from one-to— eight alphameric characters. 

filetype specifies the file type of the log. If not specified, 
filetype defaults to ZAPLOG. 

user data specifies any data that the user wishes to enter into the log. 
If user data is specified, the filetype operand is mandatory. 

Note: The LOG control record is optional and is allowed only 
if valid NAME and REP control records are found. The file 
name iobtained by the log routine from the module named in the 
NAME control record. 



Co mme nt Control Record 

The ZAP program ignores comment control records. If the PRINT option is 
in effect, the program prints the comments. The format of a comment 
record is: 



I * comment 



The asterisk must be followed with at least one blank before you enter 
the text. 



J?I£ Control Record 

The END control record ends ZAP processing* The END record is required 
and must be the last control record. The format of the END control 
record is: 



I END 

I 

i 
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SPECIAL CONSIDERATIONS FOR USING THE ZAP SERVICE PROGRAM 

Before you use the ZAP command against MODULE files, you can use the 
MODHAP command to determine whether a module map exists and what it 
contains. 

When a ZAP input file has more than one pair of VER and REP control 
records and a VER control record (other than the first") fails, you must 
remove the records prior to the failing record and correct the error 
before you issue the ZAP command again. Otherwise, the file being 
modified returns to its original status. 

If you issue a REP control record against a file that contains an 
undefined area (for example, a Define Storage area) within the REP data 
field and do not issue a VER control record prior to the REP control 
record, the bytes prior to the undefined area, if any, are modified and 
all the bytes after the undefined area are not modified. The program 
prints warning message DHSZAP248W. 

If the file tc be dumped contains undefined areas (such as a DS or ORG 
statement in a TXTLIB member) , the hexadecimal portion of the dump 
contains blanks to indicate that the corresponding positions are 
undefined. 
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Section 5. Operator Spooling Functions 



Spooling 

Input and output files for use and access by virtual machines through 
unit record devices are maintained by CP as disk data files using a 
mechanism called spooling. Individual files can be identified and 
manipulated using various console functions. The disk records are 
chained to form a logical file from dynamically assigned areas on 
specially formatted CP disk areas. Data records from disk are read into 
available page space obtained through the CP paging mechanism. The data 
records contain the actual data to be used and the CCWs to properly 
control the format. These CCWs are directly executed to perform the 
actual unit record operations on the real hardware. CP can support any 
number of virtual and real unit record devices given sufficient system 
resources. 

The data is placed in the spool buffers through the virtual machine 

unit record simulation routines in CP. Certain spool files have a 

special data format (system dumps, for example) and are accessed using a 
special interface. 



SPOOLING COKSIDESiTIONS 

VH/370 spooling facilities allow several virtual machines to share one 
or more unit record devices. Since virtual machines controlled by CBS 
ordinarily have modest requirements for unit record I/O, such device 
sharing is quite advantageous, and it is the standard mode of system 
operation. 

Each user has, as a general rule, a virtual reader, a virtual punch, 
and a virtual printer as his spooling devices * In addition, the virtual 
console can also be classified as a spool file generator as all input 
and output to the console can be logged on a spool file. This console 
log, and the files created by the user's virtual spooling devices, can 
be processed by the real unit record devices that attach to the system. 

CP controls and schedules the operation of the real unit record 
devices via spooling techniques. Virtual machine SIO instructions 
directed to those unit record devices designated as spool devices in the 
user directory entry are intercepted and modified by CP. CP generates 
another I/O operation, transparent to the virtual machine, which 
replaces the one specified. The new operation is directed to a CP 
spooling disk area which acts as intermediate storage between the real 
unit record device and the virtual machine. The data transfer operation 
between a spooled unit record device and the virtual machine is, in 
reality, between a CP spool file and the virtual machine. Spool file 
records are page size (that is, 4096 byte blocks) , and are transferred 
between storage media via the CP paging mechanisi. 
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SPOOLING FUNCTIONS 

CP spooling support performs the following five functions for virtual 
Machines: 

1. It simulates, with software routines, the operation of the virtual 
unit record devices that are attached to each user's virtual 
machine. The simulation makes it appear that the program in the 
virtual machine controls real unit record devices. Unit record 
device simulation involves the interception and interpretation of 
user Start I/O (SIO) instructions, the movement of data to and from 
the user's virtual storage space, and the reflection of 
interruption codes and ending conditions in the virtual machine. 

2. It operates the real unit record equipment attached to the real 
machine. Spooling moves print-image and punch-card-image files to 
a real printer and card punch, and creates spool files from data 
read in from the real card reader. 

3. It provides an easy-to-use interface between the virtual machine 
users, the system operator, and the spooling system to allow 
flexible and easy switching of system resources between many users. 
A set of general user and operator commands can request these 
functions. 

4. It allows keyed-in CP commands and responses as well as virtual 
machine console input and output to be placed on disk instead of, 
or in addition to, being displayed at the terminal. You can 
initiate or terminate virtual console spooling at any time during a 
terminal session. 

5. It provides the ability to spool files across the BSCS 
teleprocessing network. 

Spooling commands can be separated by type into those that affect 
virtual devices, those that affect real devices, and those that affect 
queued spool files within the system. The commands that affect virtual 
devices are available to all general users; a user may affect the status 
of devices that attach to only his virtual machine. For a discussion of 
the Class G spooling commands, see VH/370 CP Command Reference for 
General Users. 

Only the spooling or resource operator can use commands that affect 
the status of the real spooling devices. Commands affecting the user's 
virtual machine closed spool files that are awaiting processing are 
available to all users, with some additional capabilities available to 
the spooling operator. For example, a user can alter characteristics of 
only those files that have the same userid as his, but the spooling 
operator can change the status of any spool file in the system. The "CP 
Commands'* section of this publication describes these commands. 

You can create input spool files (that is, data available at a 
specific user's virtual card reader), when you Elace cards in the real 
card reader that are preceded by a special VK/370 card that identifies 
the virtual machine userid of the user requesting spool files. 

When the virtual machine operating system writes to a virtual printer 
or card punch, it creates output spool files and stores them on direct 
access devices. Real output is scheduled for a real printer or card 
punch, or for remote output, whenever a user logs off the system or 
issues a CP spooling command to close the file. 
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You can transfer specific files froa the spooled printer or card 
punch of a virtual Machine to the card reader of the same or another 
virtual machine. (A virtual card reader is not limited to 80-character 
records.) Files are not physically printed or punched when transferred 
between virtual unit record devices by the spooling routines. With this 
method, you can make files available to multiple virtual machines, or to 
different operating systems executing at different times in the same 
virtual machine. 

The Remote Spooling Communications Subsystem, with the CP spooling 
system, provides support for spooling across a teleprocessing network. 
For detailed information about RSCS, see the VM/370 Remote Spooling 
Communications Subsystem (RSCS) User's Guide . ~ 

VM/370 spooling includes many options for the virtual machine user 
and the real machine operator. These include printing multiple copies 
of a single spool file, backspacing any number of printer pages, and 
defining or reordering spooling classes for real output scheduling. 

Real printers with the Universal Character Set feature must have the 
block data check set when using VM/370 spooling. The LOADBUF command 
automatically sets the block data check. For more details on spooling, 
see "Spooling Considerations." 



Virtual Console Spooling 

The terminal user can spool virtual console output and virtual console 
input keyed in by him in addition to typing or displaying it at the 
terminal. Furthermore, if the virtual console is disconnected and the 
virtual machine is active, the console spool file acguires all console 
output that would normally print or display at the terminal. Virtual 
console I/O consists of all initiated CP commands and responses, as well 
as the communication to and from the operating system running in the 
virtual machine. 

You start virtual console spooling when you issue the command: 

SPOOL CONSOLE START 

You close the console spool file at logoff time or when you stop and 
close the file. When you close the console spool file, it goes on the 
printer spool file and then the operator can manipulate it in the same 
way as any other printer spool file. 

The display output of local or remote 3270s in DISPLAY mode (every 16 
lines) is written automatically on the spool file if the operator is the 
system operator and the device was specified as a graphic device 
supported as a virtual machine operator's console. 

Console spooling for the system operator continues even if the 
operator disconnects from one terminal and logs onto another. To stop 
the automatic console spooling, the operator must issue the SPOOL 
CONSOLE STOP command. If the system fails, up to 16 lines of output may 
be lost from the system operator's spool file, but the system closes the 
console spool file when the failure occurs. However, virtual machine 
operators may lose up to one page of spooling data in a system failure 
because their spooling buffer is one page (4096 bytes) in size. 
In regard to DASD I/O, errors occurring on spool and paging devices 
produce error messages that appear on the system operator's terminal. 
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1 user can start or stop virtual console spooling any time during a 
teriinal session with the SPOOL CONSOLE command. For a description of 
the CP SPOOL and CLOSE commands, see the YM/ 370 CP Command Reference for 
Ge nera l Osers. ~ 

B ote ; The user cannot use console spooling to stack commands for 
subsequent execution. The console spool file is for historical purposes 
only. 

I/O Error Handling 

If a permanent I/O error occurs during a real I/C operation, you restart 
the spooled files as follows: 

• Printer files — from the beginning of the current page (the last skip 
to channel 1) . 

• Punch files — froa the beginning of the spool file. 

• Reader files — froa the beginning of the real deck (the operator Bust 
noraally place the card deck back in the reader) . 

• Console files — do not restart. CP ends console spooling and purges 
the console file. The virtual Machine continues without further 
console spooling. 

Bote: If an I/O error occurs while punching accounting cards, CP 
repunches only the error card and not the whole file as in the case of 
noraal punch spool files. 



SPOOL BUFFERS 

The buffers used in virtual machines while collecting and writing spool 
data are each One page (4096 bytes) long, and contain both the data to 
be transcribed and all CCWs necessary for operating the unit record 
devices that perfora the transcription. Systea failures that end system 
operation can cause virtual machine operators to lose up to one page of 
spooling data. 

Buffers used for the temporary storage of spool data on its way 
between auxiliary storage and the user f s virtual machine are allocated 
from a pool of virtual pages that belong to CP. Direct access devices 
provide the auxiliary storage necessary for CP spool buffering. 

CP uses unit record devices to spool input and output operations. 
However, certain features or functions that pertain to this group of 
machines are not supported. Consult the VH/370 restrictions listed in 
the VH/370 Introduction and the list of devices suitable for spooling 

dAviroe fho+k nnit rocnr^ anfl fliror*' acooect lis+sd i n **ADDS!idiz St 

System Requirements.** Also see the VH/ 370 Planning and System 
Generation Guide. 
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SPOOL FILES 

Each spool file in the system has a number of attributes that are 
assigned to it, either explicitly or by default* at the time that it is 
created. These attributes and their values are as follows: 

Filename and Fi lety pe; Each of these consist of alphameric fields of up 
to eight characters. The CHANGE or CLOSE command can change these 
fields. 

Spoolid: This is a system-assigned number between 1 and 9,900. It is 
automatically assigned when the file is closed, and is unique to that 
spooled file. To identify a given file, it is necessary to specify the 
userid of the file's owner, the device type, and the spoolid number. In 
most instances, the userid defaults to the ID of the user issuing the 
given command. Since the ID number, rather than the filename and 
filetype, is used as an identifier, duplicate user-assigned names do not 
present an identification problem. 

Originating User ID: This is the ID of the file's creator, if the file 
has been internally transferred from the originator "s virtual printer or 
punch to a new owner* s virtual card reader. 

Nu mber of Copies: This is the number requested for an output spool file; 
it This is a number between 1 and 99. Unless specified by the user or 
operator, it defaults to 1. 

Date and Time: This is the date and time that the file was created. 
Users create most files from virtual spool devices and the date and time 
indicate when the originator of the file closed the device. 

Nu mber of Records: This is a six-digit number indicating the number of 
logical record (printer or card images) in the file and is an indication 
of the size of the file. 



OUTPUT CLASSES 

In addition to the attributes described above, a file queued for output 
on a real unit record device always has an output class associated with 
it. A single alphameric character (A through Z, through 9, and the 
special character *) controls what real device the file is to be printed 
or punched on, and the relative priority and sequence of output on the 
device. Although each file is assigned a single class, you can 
designate each real spooling output device to handle from one to four 
classes. The device processes only files that have a class code that 
corresponds to one of its own, and processes these files in the order 
you specify. For example, if you assign a printer the classes A, D, and 
2, it always processes any printer file with class A before it searches 
the printer output queue for a file with class E, and all class D files 
are printed before any file with class 2. You can assign a class of * 
to a real output unit record device to allow that device to process any 
class spool file. ^ 
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The output class for a file is assigned at the tine of the file's 
creation and is the class that is associated with the virtual device 
that created it. When a user logs on to the system, the class 
associated with the device is the one defined in his user directory 
entry for that device; however, he may alter this class at any tiie with 
the SPOOL command. After files are closed and are awaiting output, 
their class can be altered with the CHANGE command either by the file's 
owner or by the spooling operator- The spooling operator can alter the 
standard assignments of output classes of a real output device with the 
START command. 

Output priorities can also be rearranged by altering the hold status 
of a file. The system operator can hold or release the files of 
specific users, all files of a given type, or all files in the system. 



Through judicious combination of the class 
operator can exercise flexible control of the 
can use the class function to direct outp 
containing special forms or special print tr 
force a specific priority scheme. The hold 
immediate processing of high priority output f 
volume or low priority jobs to be deferred for 
low system usage. 



and hold functions, the 
spooling functions. He 
ut to specific printers 
ain arrangements, and to 
function can ensure the 
iles, while allowing high 
output until periods of 



SPOOLIHG COMMANDS 



The commands shown in Figure 13 control VM/370 spooling operations, 





User Classification 


Command 


General User | Spooling Operator 


BACKSPAC 


I x 


CHANGE 


X | X 


CLOSE 


x I 


DRAIN 


i X 


FLUSH 


I x 


FREE 


I x 


HOLD 


I x 


LOADBOF 


I x 


ORDER 


X | X 


PURGE 


X | X 


REPEAT 


1 T* 

1 A 


SPACE 


1 x 


SPOOL 


X I 


START 


1 x 


TAG 


X | 


TRANSFER 


X I X 



Figure 13. CP Spooling Commands 



This list represents all the CP commands that pertain to spooling 
operations. Users having privilege classes D (the spooling operator) 
and G (the general user) can issue these commands. Users with only the 
G privilege class cannot invoke class D commands. 
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The spooling operator has responsibility for the following unit 
record spooling operations. He oust: 

1. Verify that the special VM/370 user identification (ID) card 
precedes a user's physical deck of cards to associate the cards 
with the correct user's virtual Machine (see "Spooled Card Input.*) 

2. Make sure that sufficient blank cards are available for the punch 
unit, and that the paper in the printer is the proper size, width, 
and number of copies, and that the proper print train is Mounted 
and the print buffer is properly loaded. 

3. Separate punched and printed output by user identification (userid) 
code. 

4. Start, stop, restart, or rearrange the sequence schedules of spool 
files to be printed or punched. 

The spooling commands are discussed (along with other operator 
commands) in the "Operator Commands" section. 



IQLQG Password 

The NOLOG password is reserved for users who are not assigned any 
privilege class. These users cannot log on to a virtual machine. The 
user with the NOLOG password can submit jobs to the CHS Batch facility 
via the real card reader. The user with the NOLOG password can also be 
the recipient of spool files sent by any other logged-on user only if 
the other user issued a SPOOL FOR command to the userid having the NOLCG 
password. 



SPOOLED CARD INPOT 

Spooled input from a real card reader requires a CP ID (identification) 
card before the VM/370 system can accept it for processing « 

Note: Load cards for only one user at a time. VM/370 does not look for 
ID cards in the middle of the card deck- 

The CP ID card must be inserted in front of the card deck. Then 
place the deck in the empty feed hopper. Then ready the reader device 
and push the EOF button. The reader immediately processes the cards (if 
no errors are encountered) and place the file on a direct access device. 
The file now resides in the virtual machine card reader that was 
identified by the CP ID card. Note that a file is transferred from the 
real reader to the virtual reader regardless of whether that user is 
logged on or off. The user may log on at any time to read the file. 
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CP ID Card Format 



| ID | userid [CLASS n] INANE /filename filetypeH 



(filename filetype)| 
j dsname jj 



| OSERID | | ) dsname f| | 



-j 



1. Begin punching in column 1. 

2. The first field must be one of the following: 

ID 
OSERID 

3. Separate all fields by one or more blanks. 

4. The second field must be the user's identification (userid) , 
limited to eight characters. 

5. The third field (optional) is CLASS n (if class is assigned) ; one 
or more spaces must separate the vord CLASS and the class 
designation (n) . (A through Z and through 9 are valid class 
designations.) If the class option is not coded, the file defaults 
to class A. If the class option is coded, it must immediately 
follow userid. 

6. The fourth field (optional) is the keyword HAME, followed by 
filename and f iletype (or dsname alone) . If only a dsname is 
specified, it can be 24 characters long. If both filename and 
filetype are coded, they are each restricted to a maximum of eight 
characters and must be separated by a blank. 

An invalid or missing user CP ID card on the front of a card deck, 
when read, causes an error message on the system console. 



Sp ool Printer and Punch Output 

Printed and punched output from virtual machine users is directed to the 
appropriate real unit record device. The operator (class D) can control 
this spooling output by combinations of output class, hold status, and 
other spool command operands as discussed earlier. 

Unless you used the HOSEP option to "START" a device, VM/370 prints a 
two-page separator between all output on printers and punches a 
four-card separator between all output on punch devices. 

The printer separator gives the pertinent spool file characteristics 
as well as real device data. The separator prints the owner userid and 
distribution code in block letters on two pages. The separator does not 
print between multiple copies of the file. 

The card separator gives the owner's userid and the distribution 
code. The distribution code is expanded to punch each character in four 
columns with two separating blanks so that visual interpretation of the 
punched data is easier. 
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Because output for a user file starts on a real device, the following 
message occurs: 

PRT) raddr /OUTPUT OF) userid FILE = file RECDS = norecs COPY = nn a typ 



/PRT) raddr /OUTPUT OF) 
(PUN) ( REPEATED J 



whe re: 

raddr is the real device address. 

userid is the identification of the owner of the spool file. 

file is the spool file spoolid number. 

norecs is the logical record count (lines or cards) for the 
file. 

nn is the current copy number being produced where 01 is the 
last copy. 

a is the spool file class. 

typ is the originating device typ (PET, PUN or CON) . 

The OUTPUT OF message occurs when the file output first starts and 
the REPEATED message occurs for subseguent copies of the same file as 
they start. 

As the card deck starts reading through the real device, the operator 
receives the following message: 

RDR raddr INPUT FOR userid FILE = file 

whe re: 

raddr is the real address of the card reader. 

userid is the user identification of the owner of the file from 
the ID card at the front of the deck. 

file is the spool file spoolid number assigned. 

An invalid or missing user identification card on the front of a card 
deck, when read, causes an error message on the system console. 



SPOOL FILES FOR VIRTUAL MACHINES RUNNING BATCH JOBS 

Usually, when an installation has only one real reader, printer, or 
punch, the unit record devices must be shared by all virtual machines. 
Before VM/370 can process any virtual machine CP spool files and direct 
them to a real device, those files must be closed. For virtual machines 
executing batch jobs and using operating systems other than CMS, usually 
the operator who initially program loaded the virtual machine operating 
system must intervene to issue the CP CLOSE command. 
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A feature that closes CP spool files is available for 0S/VS1. When 
the VM/VS Handshaking feature is active, VS1 closes the CP spool files 
by issuing the CP CLOSE command when the VS1 Job output from its DSD, 
terminator, and output writer is completed. Once output files are 
closed, they can be processed by VM/370 without operator intervention. 

Without the VM/VS Handshaking feature, CP spool files are not sent to 
the real printer or punch until the virtual machine operator intervenes. 



I Using the CMS Batch Facility 

| The Batch Facility is a VM/370 programming facility that runs under CMS. 

| It allows a VM/370 user to run jobs in batch mode by sending jobs from 

| either his own virtual machine or the real card reader to a virtual 

| machine dedicated to running batch jobs under the Batch Facility. This 

I dedicated machine is generally set up at a terminal in the 

| installation's computer room and is controlled by the system operator. 

| The Batch Facility virtual machine runs continuously, executing all 

| jobs spooled to its virtual card reader from other virtual machines or 

| from the real card reader. The batch operator need pay no attention to 

| the batch machine once he has started, and disconnected it. 



| STARTING THE BATCH VIRTUAL MACHINE 

I The system operator starts the batch virtual machine by logging on with 
| a batch userid and loading CMS using the CP IPL command. 



I The Batch Userid 

| Every installation in which the CMS batch facility is available should 

| establish one or more common userids for the Batch Monitor virtual 

| machine. Users can then spool their files for execution to the card 

| reader for that batch userid. 

| It is the operator 1 s responsibility to log on the VM/370 system using 

| the batch userid that has been established for his installation* 

| The userid established for the batch facility virtual machine must 

I have a read/write work disk in its directory at virtual address 195. 

I The 195 disk is erased when it is accessed as the A-disk at the 

| beginning of each job. 
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! Invoking th e Batch Facilit y 



The batch facility virtual machine is invoked by the batch operator when 
he issues the CP IPL command with PAEM BATCH or CP IPL followed by the 
CMSBATCH command. The latter method follows: 

ipl cms 

CMS mm/dd/yy WED 17.58.48 

cmsbatch 

Y/S (19E) R/0. 

THE FOLLOWING NAMES ARE UNDEFINED: 

BATEXIT1 BATEXIT2 
R; T=0. 14/0.39 08:47:40 
WAITING FOR THE READER 

The operator may now disconnect the batch machine terminal, if he 
wishes, using the CP DISCONN command. The Batch Facility will IPL 
itself after each job is executed. 

All virtual machine (CHS) console output is automatically spooled to 
a file to be printed after the program output at the real system 
printer. All commands entered through the virtual reader are displayed 
on the console to allow them to appear in the console output file. If 
the batch terminal is disconnected, only CP and batch initialization 
messages are displayed at the terminal. 

If an installation wishes to use a saved system in running batch 
jobs, the operator must enter the name of the saved system in the 
CMSBATCH command line. 



CONTROLLING THE BATCH FACILITY 



The batch facility permits CP and CMS commands to be issued from the 
batch job stream submitted by the user. 

The following CP commands, and only these commands, control the batch 
virtual machine: 

• CHANGE - May not be used to change the virtual card reader* 

• CLOSE - May not be used to change the virtual card reader. 

• DETACH - May not be used to change the virtual spool devices or the 

system, IPL, or 195 disks. 

• DUMP 

• DISPLAY 

• LINK - A maximum of 10 links may be in effect at any one time; 

and, LINK must be used as shown in the following format: 

CP LINK userid vaddr vaddr mode password 

• MSG 

• QUERY 

• SET - Only the following SET command operands are allowed under 

CMS batch: 



ABBREV 


NONSHARE 


DOS 


RDYMSG 


IHPEX 


SYSNAHE 


LDRTBLS 


UPSI 



SPOOL 
STORE 
TAG 



- May not be used to change the virtual card reader. 
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When CP commands are used to control the CMS batch virtual machine, 
they must be preceded by the CHS CP command, because the implied CP 
function is disabled when batch initializes a job. 

The following CMS commands are disabled under the Batch Monitor,: 

READCARD 
DISK LOAD 

The FILEDEF and ASSGN commands are also disabled for use in defining 
the virtual card reader. 

A more complete description regarding control of the CMS Batch 
virtual machine is contained in the VM/370 : CMS User's Guide * It 
describes the user control cards and suggests control techniques as well 
as how to control the batch machine using EXEC procedures. 

The batch virtual machine spools output resulting from program 
execution to the system printer. Output is printed under the submitting 
userid, with the submitting userid* s distribution code, a spool filename 
of CMSBATCH, and a spool filetype of JOB (unless a job name was 
specified on the /JOB card). 

The console output is always spooled. Therefore, if the console is 
disconnected, the CMS console output is spooled to a file that is 
printed following the user's program execution output at the real system 
printer, with the submitting userid as distribution code, a spool 
filename of BATCH, and a spool filetype of CONSOLE. 

If the CP TAG command has been used to identify spool files or to 
direct these files to other virtual machines or remote work stations, 
BATCH resets the spooling devices for the next job. 



PURGING, REORDERING, AND RESTARTING BATCH JOBS 

When reguired, the spooling operator can control the execution of batch 
virtual machine jobs by purging, reordering, and restarting them; by the 
same token, because all the closed printer files are queued for system 
output under the submitting userid, the submitting user can change, 
purge, or reorder these files prior to processing on the system printer. 

To purge a job executing under the Batch Monitor, follow the 
procedure below: 

1. Signal attention and enter the virtual machine environment. 

2. Enter the HX (halt execution% immediate command. 

3. Disconnect the virtual machine using the CP DISCONN command. 

The HX command causes the Batch Facility to abnormally terminate. 
This provides the user with an error message and a CP dump of the Batch 
Facility virtual machine. The Batch Monitor then loads itself again and 
starts the next job (if any) . 

To purge an individual input spool file that is not yet executing, 
issue the CP PURGE command: 

PURGE READER spoolid 
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In the previous format, spoolid is the spool file number of the job 
to be purged from the batch virtual machine's job gueue. For example, 
the statement: 

PURGE READER 123 

would purge 123 from the batch virtual machine's job gueue. 

To reorder individual spool files in the Batch Facility's job gueue, 
use the CP ORDER command: 

ORDER READER spoolidl spoolid2. .. 

In this format, spoolidl and spoolid2 is the assigned spool file 
identification of the jobs to be reordered. 

The operator can determine which jobs are in the gueue by using the 
CP QUERY command: 

QUERY READER ALL 

This QUERY command lists the filenames and filetypes of all the jobs 
in the batch virtual machine's job gueue. The operator can then reorder 
them, using the ORDER command. 



STOPPING THE BATCH VIRTUAL MACHINE 

When you want to stop batch virtual machine execution after completion 
of the current job, you can issue the HB immediate command and press the 
attention key or equivalent to cause an attention interruption at any 
time during the job. This causes the batch virtual machine to be logged 
out at job completion. 

When Batch Facility virtual machine execution is to be stopped 
immediately, but current files must be saved, you can use the CP SPOOL 
command, in the form SPOOL READER HOLD, and then issue the CP LOGOFF 
command. 

The HOLD option causes CP to retain the virtual machine's current 
card reader file, so that when the Batch Facility is logged on again, 
execution resumes at the beginning of the held reader file. 

If an emergency shutdown should occur, all jobs in the batch reader 
and all spool files are saved. 



SUPPORT OF THE 3800 PRINTER AS A REAL VM/370 SPOOLING DEVICE 

Virtual machines can print spool files on the 3800 printer. However, 
the use of more than one translate table for printing a given file notes 
an exception. Once the user starts to print a spool file with specific 
character sets, the entire file must be printed with these character 
sets. At any time, the user may change the characteristics of a spool 
file before it actually starts printing. 
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Appendix: Summary of CP Commands 



This section is provided as a quick-reference summary of the VH/370 CP 
commands. Additional information concerning the commands can be 
obtained from the VM/370 CP Command Reference for General Users. 

Be aware that all commands are not available to every virtual machine 
user. Rather, the commands belong to different classes that represent 
different areas of computer activity. 

The class of commands that a user can issue is contained vith the 
user's identification code in the system directory. The system directory 
is controlled by the system operations personnel. 

The CP commands can be arranged in five categories: 

• Program analysis and monitor functions. 

• Device control functions. 

• Virtual console functions. 

• Spooling and file control functions. 

• Miscellaneous functions (those commands that do not belong in any of 
the above categories) . 

Hany command names and operands can be truncated. Where truncation 
is permitted, the shortest acceptable version of the command is 
represented by uppercase letters, with the optional part represented by 
lowercase letters. (Remember, however, that any VH/370 command can be 
entered with any mixture of uppercase and lowercase letters. 



PROGRAM ANALYSIS AND MONITOR FUNCTIONS 



Command Explanation 

ACNT Render accounting information for and to the virtual user 
(Class A) . 

ADSTOP Specify an instruction address location where the user's 
program is to be halted (Class G) . 

DCP Display real processor storage locations (Class E) . 

Display Display virtual console registers, plus the current CAN, 
CSW, and PSN (Class G) . 

DMCP Dump the real storage locations to a user's virtual printer 
(Class E) . 

DUmp Dump virtual machine registers and storage to the virtual 
printer (Class G) . 

LOCate Provide the starting location of the CP control blocks 
associated with a user or his virtual (or real) devices 
(Class E) . 
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Coiaan d Ex pla nation 

HOHitor Initiate or terminate the recording of events that occur in 
the real Machine (Classes A and E) . 

SAVESYS Provide a storage copy of virtual Machine storage, 
registers, and PSW contents as they currently exist (Class 
B). 

STCP Change the contents of real processor storage (Class C) - 

TBace Trace virtual Machine activity at the terminal, spooled 
printer, or both (Class G) . 



DEVICE CONTBOL FOHCTIOHS 

Coaaand Explanation 

ATTach Attach a real device for VM/370 control (Class B) . 

COUPLE Connect virtual channel to channel adapters (Class 6) . 

1 DEFine Alter the device feature of a 3330V (Class E) . 

DETach Beaove a real or virtual device or channel from a virtual 
Machine or the real systeM (Class B and G) . 

DISAble Disable direct or switched communication lines from the 
VM/370 systeM (Class A or B) . 

DISConn Disconnect the user's terminal from his virtual Machine 
(Class Any) . 

EHable Connect specified coMMunication lines to the systeM. (Class 
B). 

Link Provide access to a specified DASD device by a user's 
virtual Machine (Class G) . 

LOADBUF Load the 1403 universal character set (DCS) buffer with a 
specified train image. This coniand also has options that 
control a 3211 printer (Class D) . 

LOADVFCB Load the virtual foris control buffer for a virtual spooled 
3211 printer (Class G) . 

HSTwork Allow the enabling and disabling of all or specific 
3704/3705 resources. In addition, the network coaaand is 
used to vary resources offline or online (Class A and B) . 

VABY Allow or disallow the availability of a device to a virtual 
Machine or the VM/370 control program (Class B) . 



VIBTUAL CONSOLE FUNCTIONS 



Co aaand Explanation 

Begin Continue or resume execution of the virtual Machine at a 

specified storage location or at the address specified in 

the current PSW (Class G) . 
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Command Explanation 

EXTernal Simulate an external interruption condition for a virtual 
machine and return control to that machine (Class G) . 

ipl Initiate a program load for a virtual machine (Class G) . 

RESET Clear all pending interruptions on a specified device (Class 
G). 

SPool Allow the starting or stopping of virtual console spooling 
as well as the alteration of other spooling control options 
(Class G) . 

STors Alter registers and storage of a virtual machine (Class G) . 

SYStem Initiate the virtual VH/370 console functions of clear. 
System Reset, and PSfl Restart (Class G) . 

TERHinal Redefine the user's terminal input characteristics and 
attention interruption handling capabilities (Class G) . 



SPOOLING AND FILE CONTROL FUNCTIONS 



Command Exp lanat ion 

BAckspac Restart or backspace the output of a unit record spooling 
device (Class D) . 

CHange Alter one or more attributes of a closed spooled file (Class 
D and G) . 

Close Terminate a spooling operation on a virtual console, reader, 
printer, or punch (Class G) . 

DRain Stop spooling activity on the specified device after the 
current file in operation reaches termination (Class D) - 

Flush Eliminate and halt the current file output on the specified 
real unit record device (Class D) . 

FRee Release spool HOLD status from previously held files for 
real RDR, PUN, and PTR devices (Class D) . 

Hold Defer file output to the real RDR, PTR, and PUN devices 
(Class D) . 

ORDer Redefine the order of closed spool files (Class D and G) - 

PUrge Remove spooled file(s) before reading, punching, or printing 
(Class D and G) . 

REPeat Add to the number of copies of an output printer or punch 
file on a real unit- record device (Class D) « 

SPAce Force single space on the printer, regardless of carriage 
control codes contained in the file (Class D) - 

SPool Change spooling control options on a given device or group 
of devices and also starting or stopping of console spooling 
(Class G) . 
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Command Explanation 

STart Start a unit record device, or restart a drained device, or 

restart and change output classes that it may service (Class 

D). 

TRANsfer Direct an input spool file to or retrieve it from a 
specified user's virtual card reader (Class G) . 



MISCELLANEOUS FUNCTIONS 



Command 



#CP 

ATTN 
AUTOLOG 

CP 

DIAL 

DEFine 
ECho 

FORCE 

HALT 

INDicate 



Logon 
Login 

LOGoff 
LOGout 

LOCK 

Message 
Hsg 

HONitor 



MSGNOB 



Explanation 

Provide a means of inserting commentary in the stream of 

virtual console input and output messages (Class Any) . 



Allow CP command execution while remaining in the virtual 
(Class Any) . 



- ofxJ1 y cw aj.^uai a l. v,cu nun 



Create an interruption pending from the virtual console 
(Class G) . 

Provides a means to automatically log on and load any 
virtual machine with IPL defined in its directory (Class A 
or B) . 

Allow the user to key in CP commands following "CP" while in 
the CHS or virtual machine environment (Class Any) . 

Logically attach a user terminal to a multi-access virtual 
system (Class Any) . 

Reconfigure one's own virtual machine (Class G) . 

A terminal test facility that allows keyboard entered data 
to be displayed back at the user's terminal (Class G) . 

Force the logoff of any virtual machine (Class A) . 

Stop any active channel program on a specified device (Class 
A). 

Displays use of and contention for major system resources 
(Class E and G) . 

Gain access to a virtual system from a user terminal (Class 
Any) . 

Terminate user activity on a virtual machine (Class Any) . 



Lock a user's pages in processor storage (Class A) . 

Send a specified message from one virtual machine to 
another (Class A, 8, or Any) . 

Records system counters needed for performance measurement 
(Class A and E) . 

Send a specified message, without the standard MESSAGE 
header, from one virtual machine to another (Class B) . 
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Co mma nd Explanation 

NETwork Provide loading, dumping, tracing, and other functions for 
the 3704/ 37 °5 Comaunications Controller. 

NOTReady Simulate the not-ready status on a virtual spooled unit 
record or virtual console device (Class G) . 

Query Provide status information on the real or virtual machine, 
and miscellaneous CP functions (Class A, B, C, D, E, F, and 
G). 

Ready Simulate a ready (device end interruption) condition for a 
specified virtual device (Class G) . 

REQuest Hakes an interruption pending from the virtual console 
(Class G) . 

REWind Rewind a tape to the load point on a real device attached to 
a user's virtual machine (Class G) . 

Set Establish system parameters for virtual and real machines, 
as well as other VM/370 values (Class A, B, C, E, F, and G) . 

SHUTDOWN Terminate VM/370 activity in an orderly manner and 
checkpoint the system (Class A). 

SLeep Place the virtual machine in a dormant state, with the 
keyboard locked (Class Any) . 

UNLOCK Release previously locked page frames of real storage (Class 
A). 

Warning Transmit high priority messages or warnings to a user or all 
Wng users (Class A or B) . 
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Index 



A 

abbreviations of commands 41 

ABEND dumps, system 36 

ACNT, command (CP) 44 

AFFINITY 

automatic set/reset 5 

usage with attached processor 34 
(see also SET command) 
ALLOCATE control statement Format/Allocate 

program 176-177 
allocating, DASD space for CP use 176-177 
alternate, track assignment, IBCEASDI 189 
alternate console 

at system generation 14 

automatic logon 14 

disconnecting 20-21 

multiple 19-20 

specifying 14 

valid terminal designations 14,19-20 

VH/370, selecting 21 
assigning, an alternate track, IBCDASDI 

189 
ATTACH, command (CP) 45-49 
ATTACH CHANNEL, command (CP) 50-51 
attached processor system 

AFFINITY command usage 34 

clock synchronization 18-19 

initialization 18 

locked shared pages, restriction 31 

restarting 5 

specifying one processor 34 
attaching, and detaching volumes, user and 

system 8 
attributes, spool file 213 
ADTOLOG, command (CP) 52-53 
automatic logon, operator 15 
autoaatic volume mount and demount 

3330V 17 

causes 17 



B 

BACKSPAC, command (CP) 54-55 

BASE, ZAP control record 203-204 

braces 

nested 42 

to indicate choices 42 
brackets 

nested 43 

to indicate choices 43 
buffers, spool 212 



CABCEL key 

on supported VH/370 terminal consoles 
restrictions 
3066 8 
3215 8 
3270 8 
capacity cf device when formatted 172 
card input 

spooled 215 

to Format/Allocate program 174-175 
card separator, spool punch output 216 
CCH (Channel Check Handler) 3 
CHANGE, command (CP) 56-58 
Channel Check Handler (see CCH (Channel 

Check Handler)) 
character set 
3800 printer 

modification 26 
predefined 26 
checkpoint (CKPT) start, VH/370 14 
CKPT (see checkpoint (CKPT) start) 
class (see privilege class) 

output, spool files 213-214 
clock 

setting, (uniprocessor application) 

11-12 
synchronization, (attached processor) 

18-19 
time-of-day (TOE), description 10-11 
CHS 

commands 

(see also commands) 
GEHIHAGE 170 
IHAGELIE 170 
NCPDDMP 199-200 
VHFDDHP 36 
ZAP 200 
using CHS to alter VH/370 files, 
157-158 
cold start, VH/370 12-13 
command format 42-43 
commands 

(see also CHS commands, CP commands) 



Index 225 



CP 

command privilege classes 37 

commands 37-155 

entering 7-8 

miscellaneous functions 222-223 

nesting 43 

notational conventions 41-43 

privilege class assignments 39-40 

privilege classes, description 38 

spooling 214 

summary 219-223 

used for analysis and monitor 

functions 219-220 
used for device control 220 
used for spooling and file control 

221-222 
used for virtual console 220-221 
3704/3705 control program 157 
COMMENT, ZAP control record 206 
Communications Controller, (see also 

3704/3705 Communications Controllers) 
considerations 

for virtual=real performance option 

29-30 
spooling 209 
console 

alternate 

description 19-20 
selecting 21 
definition 19-20 
input 

procedures 7-8 

to Format/Allocate program 178-179 
■essages, after VH/370 initialization 

24-25 
primary 

description 19-20 
disabling 20-21 
system, description 19-20 
virtual, (see also virtual console) 
Control Program (see CP (Control Program) ) 
control records 

BASE, ZAP program 203-204 
COMMENT, ZAP program 206 
DOMP, ZAP program 201-202 
206 
206 

203 
205 

204-205 
201-206 



END, ZAP program 
LOG, ZAP program 
NAME, ZAP program 
REP, ZAP program 
VERIFY, ZAP program 
ZAP service program 



control statements 
DDR program 

(see also function statements, DDR) 

INPUT 160 

OOTPOT 160 

SYSPRINT 161 
Format/Allocate program 

ALLOCATE ~ 176- 177 

FORMAT 175-178 

LABEL 177-178 



IBCDASDI 

DADEF 185-186 
END 188 
GETALT 190-191 
IELTXT 188 
JOB 184 
LASTCARD 188 
HSG 184 
VLD 187 
VTOCD 187-188 
controlling 

3704/3705 Communications Controller 

21-22 
3704/3705 Communications Controllers 
157 
conventions, environment 7-8 
Conversational Monitor System (see CMS) 
CCEY, function control statement. DDR 

program 162 
copy modification, description for 3800 

printer 26 
CP assist 33 
CP commands 37-155 

(see also commands) 
ACNT 44 
ATTACH 45-49 
ATTACH CHAHNEL 50-51 
A0TCLOG 52-53 
BACKSPAC 54-55 
CHANGE 56-58 
DCP 59-61 
DEFINE 62-63 
DETACH 64-66 
DETACH CHAHNEL 67 
DISABLE 68 
DMCP 69-71 
DRAIfl 72 
ENABLE 73 
FLUSH 74-75 
FORCE 76 
FREE 77 

HALT TO 
HOLD 79 
INDICATE 80-85 
LOADBUF 86-88 
LOCATE 89 
LOCK 90-91 
MESSAGE, 92-93 
MQNITQB 94-104 
BSGBCB 105 
HET^CRK 106-116 

A and B privilege classes 110 

A privilege class 108 

F privilege class 115 
ORDER 117 
PURGE 118-119 
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QDERI 120-135 

A,B,C, and E privilege class 133 
A,B,C,D,E, and F privilege class 134 
A and E privilege class 120-122 
B privilege class 123 
D privilege class 130 
REPEAT 136-137 
SAVESYS 138 
SET 139-143 

A privilege class 139-141 
B privilege class 142,193-194 
F privilege class 143 
SHUTDOWN 35,144 
SPACE 145 
SPOOL 211-212 
START 146-147 
STCP 148-149 
summary 219-223 
TRANSFER 150-151 
UNLOCK 152 
VARY 153-154 
WARNING 155 
CP ID card 

description 216 
usage 216 
CPEREP program, error recording, I/O 4 
creating 

a CHS dump file 197 
dump files 193-194 
cylinder zero format 172-174 
cylinders, format for CP use 172-174 



DADEF control statement, IBCDASDI 185-186 
DASD (Direct Access Storage Device) 
(see also disks) 
for~spool buffering 212 
space, allocating on CP owned volumes 

176-177 
volumes 

formatting 171 
labeling 177-178 
DASD Dump Restore (DDR) program 158-168 
control statements 
INPUT 160 
OUTPUT 160 
SYSPRINT 161 
DDR command 158-159 
function control statements 162-167 
COPY 162 

description 162-167 
DUMP 162 
PRINT 165-166 
RESTORE 162 
TYPE 165-166 



invoking 

as a standalone program 159 
under CHS 158-159 
I/O definition statements 160 
DCP, command (CP) 59-61 

dedicated device, 3800 printer support 26 
defaults, usage in underscored notation 42 
DEFINE, command (CP) 62-63 
DETACH, command (CP) 64-66 
DETACH CHANNEL, command (CP) 67 
detaching, and attaching volumes, user and 

system 8 
device control - CP commands used 220 
direct access storage device (see DASD 

(Direct Access Storage Eevice)) 
DISABLE, command (CP) 68 

disabling the primary VH/370 console 20-21 
disks 

allocating space for CP use 176-177 

for spool buffering 212 

volumes 

formatting 171 
labeling 177-178 
DHCP, command (CP) 69-71 
DHKDDR (see DASD Dump/Restore (DDR) 

program) 
DHKFHT (see Format/Allocate program) 
DBKHSS, mass storage system error messages 

17-18 
DCS virtual=real storage assignments 31 
DRAIN, command (CP) 72 
dump 

from 3704/3705 199-200 
processing 199=200 
DUHP 

function control statement, DDR program 

162 
NETWORK command usage 198 
operand, of SET command (CP) 193-194 
dump 

system ABEND 36 
unit, for system failure 35 
DUHP, ZAP control record 201-202 
dump file 
CHS 

creating and printing 197 
printing 197 
CP ABEND 

creating 193-194 
printing from tape 197 
D0BP operand, NETWORK command 198 



E 

ECPS (¥H/370 Extended Control-Program 

Support) 33 
edit, error records (see CPEREP) 
Emulation Program (EP) 

(see 3704/3705 control program) 
special considerations for loading 23 
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ENABLE, conana (CP) 73 
END 

control statement, IBCDASDI 188 

ZAP control record 206 
environment, conventions 7-8 
EP (Eiulator Prograi (see 3704/3705 

control prograi) ~ 
EREP (see CPESEP) 
error, handling, I/O 212 
error messages, MSS 17-18 
error recording, with CPEREP prograi 
error records, editing (see CPEREP) 
execution, favored 28-29 
expanded virtual lachine assist 33 



function control stateients 
DDR prograi 
COPY 162 

description 162-167 
DOHP 162 
PRIST 165-166 
RESTORE 162 
TYPE 165-166 



GERIHAGE service prograi, description 170 
GETALT control statement, IECIASDI 190-191 



facilities 

VM/370 repair 5 

VM/370 restart 5 
failure, VM/370, recovery froi 13-14 
favored execution option, description and 

usage 28-29 
feature 

(see also DEFINE conand) 

defining""for a 3330V 17 

sysvirt 17 

virtual 17 
filenaie, attribute, spool files 213 
filetype, attribute, spool files 213 
ELOSH, conand (CP) 74-75 
FORCE, command (CP) 76 
force start, VM/370 14-15 
FORMAT, control statement, Foriat/Allocate 

program 175-178 
format 

of cylinder zero 172-174 

of cylinders for use by CP 172-174 

of user identification card 216 
Format/Allocate program 172-180 

ALLOCATE control statement 176-177 

card input 174-175 

console input 178-179 

control statements 175-178 

example of program execution 178-179 

FORMAT control statement 175-178 

LABEL control statement 177-178 
formatted device capacity 172 
formatting, voluies, general information 

171 
foris control, description for 3800 printer 

26 
foris overlay, description for 3800 printer 

26 
FREE, command (CP) 77 



H 

HALT, command (CP) 78 
handling, I/O errors 212 
hardware assist 

(see al so virtual machine assist; VM/370 
Extended Control Program Support) 

description 32 

restrictions 34 
hardware status messages 24-25 
HOLD, command (CP) 79 



IBCDASDI disk initialization program 
control statements 183-193 

DADEF 185-186 

END 188 

GETALT 190-191 

IPLTXT 188 

JOB 184 

LASTCARD 188 

HSG 184 

VLD 187 

VTOCD 187-188 
general information 180-181 
invoicing 192-193 
restrictions 181 
IHAGELIB service program, description 170 
IHEICATE, command (CP) 80-85 
initialization 

attached processor system 18-19 
disk (see IBCDASDI) 
mass storage system (HSS) 17-18 
messages 24-25 
minidisk 180-193 
systei 9-10 

with surface analysis 182 
without surface analysis 182 
initiating, VH/370 operation 7-36 
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input 

card, to Format/Allocate program 
174-175 

console, to Format/Allocate program 
178-179 

control records, ZAP 201-206 

spooled card 215 
INPOT control statement, DDR program 160 
input/output (see I/O) 
Interactive Problem Control System (see 

IPCS) 
interval timer 19 

at initialization 19 
interval timer assist, part of ECPS 33 
invoking 

DDR 

as a standalone program 159 
under CMS 158-159 

IBCDASDI 192-193 
I/O 

definition statements, DDR program 160 

error, handling 212 

error recording, with CPEREP program 4 
IPCS commands, VMFDUMP 36 
IPLTXT control statement, IBCDASDI 188 



JOB control statement, IBCDASDI 184 



LABEL, function, Format/Allocate program 

177-178 
labeling, DASD volumes 177-178 
LASTCARD control statement, IBCDASDI 188 
LOADBUF, command (CP) 86-88 
leading 

3704/3705 Communications Controllers 22 
3704/3705 control program 16,22,157 
EP considerations 23 
NCP considerations 21-22 
PEP considerations 22 
LOCATE, command (CP) 89 
LOCK, command (CP) 90-91 
locked pages option, VM/370 31-32 
locked shared pages, attached processor, 

restriction 31 
LOG, ZAP control record 206 
logon 

automatic 15 
manual 15 

message, automatic 15 
lowercase letters, words and symbols 42 



machine check handler (MCH) , error 

recording 3 
manual logon, operator 15 
maE, storage allocations 31 
mass storage control (MSC) # communicating 

with 17 
mass storage system (MSS) 

CP automatic volume demount 17 

CP automatic volume mount 17 

error messages 17-18 

initialization 17-18 

SHUTDOUN process 144 

specifying a partition 17 
MCH ( se e machine check handler (MCH) ) 
MESSAGE, command (CP) 92-93 
messages 

console, after VM/370 initialization 
24-25 

for virtual machine users 24 

hardware and program status 24-25 

logon 15 

status, VM/370 operation 24-25 

system initialization 24-25 

to system operator, SVC 76 24 
minidisks, initializing 180-193 
MONITOR, command (CP) 94-104 
monitor functions - CP commands used 

219-220 
HSC (see mass storage control) 
MSG, command (CP) (see MESSAGE command) 
MSG control statement, IECEASDI 184 
MSGBOH, command (CP) 105 
MSS (see mass storage system) 
multiple alternate consoles, selection 
19-20 



N 

HAKE, ZAP control record 203 

NCP (see Network Control Program (NCP)) 

NCPDDMP 

command 199-200 

program 199-200 

usage 199-200 
nested commands (CP) 43 
NETWORK 

command (CF) 106-116 

3270 resource identification 107 
NETWORK command 

DUMP operand 198 

dump operations 198 



format 

class A 108 
class A and E 
class F 115 



110 
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LOAD operaod 
usage 16,22 

usage for remote 3270 107 

usage for reiote 3740/3705 107 
Network Control Program (NCP) 

(see also 3704/3705 control prograi) 

special considerations for loading 23 
NOLOG password 215 

notational conventions, CP commands 41-43 
number of copies, spool file attribute 213 



operating procedures, VH/370 8-9 
operations, VH/370, initiating 7-36 
operator 

commands, CP 41 

responsibilities, for spooling 215 
operator functions, spooling 209-218 
options 

performance 

assignment of 8 

favored execution 28-29 

locked pages 31-32 

priority 32 

reserved page frames 27-28 

virtual=real 29-30 

VH/370 27 
ORDER, command (CP) 117 
OS VS EREP (see CPEREP) 
output 

spool files 216 

classes 213-214 
OOTPOT control statement, DDR program 160 



primary system operator, description 14 
primary VH/370 console, disabling 20-21 
PRIHT 

function control statement 
DDR program 165-166 
DDR program, sample output 166-168 
printer separator, spool printer output 

216 
printing 

CMS dump file 197 
CP ABEHD dump file from tape 197 
priority, option 32 
privilege class 

CP command 37-155 
user and function 38 
problem analysis, synopsis of CP commands 

used 219-220 
procedures, operating, VH/370 8-9 
processing, 3704/3705 spool dump files 

199-200 
program, status messages 24-25 
P0RGE, command (CP) 118-119 



Q 

Q0ERY 

command (CE) 120-135 

A,B,C, and E privilege class 133 
A,B,C,D,E, and F privilege class 
A and E privilege class 120-122 
B privilege class 123 
D privilege class 130 



134 



partition, specifying in OS/VS1 system 17 
Partitioned Emulation Program (PEP) 

(see also 3704/3705 control program) 

special considerations for loading 23 
password, HOLOG 215 
password suppression 52 
PEP (see Partitioned Emulation Program 

(PEP) 7 
performance options 
27-34 

AFFINITY 34 

assignment 8 

Extended Control-Program Support 33-34 

favored execution 28-29 

hardware assist 32 

locked pages 31-32 

priority 32 

reserved page frames 27-28 

virtual=real 29-30 

virtual machine assist 32 



R 

recording, I/C errors, with CPEREP program 

4 
recovery from VH/370 system failures 14 
Recovery Banagement Support (RHS) 
channel check handler (CCH) 3 
machine check handler (HCH) 3 
System/370 2 
VH/370 2 
Remote Spooling Communications Subsystem 
(see RSCS (Remote Spooling Communications 
Subsystem) 
REP, ZAP control record 205 
repair facilities, VB/370 5 
REPEAT, command 136-137 
reserved page frames, option 27-28 
resource identification, remote 3270 

devices and control units 107 
responsibilities, for spooling operator 

215 
restart 

facilities 

in attached processor operations 5 
VH/370 5 
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RESTORE, function control statement, DDR 

program 162 
restrictions 

CANCEL key 8 
IBCDASDI 181 
locked pages 31 

virtual=real performance option 29-30 
VM/370 hardware assist 31 
RMS (see Recovery Management Support 

(RMS) ) 
RSCS (Remote Spooling Communications 
Subsystem) , spooling to remote locations 
211 



SATESTS command 138 

selecting an alternate VM/370 console 21 

separator 

spool printer 216 
spool punch output 216 
service programs 
YM/370 157-207 

DASD Dump Restore (DDR) 158-168 
Format/Allocate 172-180 
IBCDASDI 180-193 
NCPDDMP 199-200 
VMFDOMP 193-196 
ZAP 200-207 
SET 

command (CP) 139-143 

A privilege class 139-141 
B privilege class 142,193-194 
F privilege class 143 
SET ASSIST 

use with ECPS 33 

use with virtual machine assist 32 
SET CPASSIST, use with ECPS 33 
SET DUMP command 36 
SET MODE MAIN, invalid for 3031, 3032, 3033 

processors 3 
SET NOTRANS CP command 30 
SET SASSIST 
coiaand 32 

usage with hardware assist 32 
use with ECPS 33 
setting TOD clock, (uniprocessor 

application) 11-12 
shared pages, attached processor system 31 
sharing devices, spooling 209 
SHUTDOWN 

command (CP) 144 
usage in system termination 35 
SPACE, command (CP) 145 
SPOOL, command (CP) 211-212 
spool buffers 212 



spool file 
attributes 
date 213 
filename 213 
filetype 213 
number of copies 213 
number of records 213 
spoolid 213 
time 213 
userid 213 
VM/370 unit record 16 
spool file control, CP commands used 

221-222 
spooled 

card input 215 
input handling 8 
output handling 8 
printer output 216 
punch output 216 
spcolid, attribute, spool files 213 
spooling 

across a teleprocessing network 210-211 
commands 

privilege classes D and G 214 
V8/370 214 
considerations 209 
devices 211-212 
functions, operator 209-218 
input spool files 211 
I/O error handling 212 
operator, responsibilities of 215 
options 211 

output spool files 211-212 
real 210 
support 209 
virtual 210 

virtual console 211-212 
with RSCS 211 
start 

checkpoint (CKPT) 14 
cold 12-13 
START, command (CP) 146-147 
start 

force 14-15 

initiating VM/370 13-14 
starting, VM/370 operations 7-36 
startup 

map of storage allocations 31 
VM/370 system 9-10 
status messages 

hardware and program 24-25 
system operation 24-25 
STCP, command (CP) 148-149 
storage allocations, map 31 
summary of CP commands, by function 

219-223 
suppression, of passwords 52 
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S?C 76 

error recording 4 
■essages to system operator 24 
SYSCOR macro instruction, AP operand 18 
SYSOPR macro instruction, used to specify 

virtual card reader file 36 
SYSPRINT, control statement, DDR program 

161 
system 

abnormal termination, dumps 36 
console 19-20 
definition 9 
failure damp unit 35 
initialization, VH/370 9-10 
messages 

after VM/370 initialization 24-25 
VM/370 initialization 24-25 
termination 35 
system operation 

apprenticeship 1 
installation requirements 1 
program requirements 1 
system operator (s ee VM/370 system 
operator) 



terminals 

for VH/370 control 19-20 
input procedures 7-8 
termination 
system 35 
virtual machine 5 
time slicing, supported by the interval 

timer 19 
time-of-day (TOD) clock 

obtaining current value 11 
setting 11-12 
System/370 10-11 
TOD clock (see time-of-day (TOD) clock) 
tracks, alternate, assigning with IBCDASDI 

189 
TRANSFER, command (CP) 150-151 
translate tables, description for 3800 

printer 26 
truncation, of commands 41 
TYPE 

function control statement 
DDR program 165-166 
DDR program sample output 166-168 





underscore, usage in notation 42 
unit record, spool files, VM/370 16 
UNLOCK, command (CP) 152 



UNLOCK command, controlling reallocation of 

virtual=real storage 29 
uppercase letters and words 42 
user identification (userid) , spool file 

attribute 213 
user identification card 

for spooled card input 216 

format 216 
user messages, virtual machine 24 
userid (s ee user identification (userid)) 
using 

DDR program 158-168 

Format/Allocate program 172-180 

IBCDASDI program 180-193 

NCPDUHF program 199-200 

VHFDUHE service program 194-195 
utility programs, VM/370 157-207 



VARY, command (CE) 153-154 
VERIFY, ZIP control record 204-205 
virtual, console (se e virtual console) 
virtual=real, VM/370 performance option 

29-30 
virtual console 

spooling 211-212 
starting 211-212 
stopping 211-212 
virtual devices, defining 9 
virtual feature, usage 17 
virtual interval timer assist 33 
virtual machine 

spooling 

considerations 209 
functions 210 ■ 

termination 5 

user messages 24 
virtual machine assist 32 
virtual machine console (see virtual 

console) 
Virtual Hachine Facility/370 (see VM/370) 
VLD control statement, IECEJSEI 187 
VHFDUHP 

command (CHS) 36 

command (IPCS) 36,194-195 

sample of initiating 196 

service program 193-196 

usage notes 195 

using 194-195 
VH/370 

checkpoint (CKPT) start 14 

cold start 12-13 

components, brief description 1 

concepts, brief description referral 1 
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